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FOREWORD 


The Software Engineering Laboratory (SEL) is an organisation 
sponsored by the National Aeronautics and Space Administra- 
Goddard Space Flight Center (NASA/GSPC) and created 
‘ T the purpose of investigating the effectiveness of soft- 
ware engineering technologies when applied to the develop- 
ment of applications software. The SEL was created in 1977 
and has three primary organizational members: 

NASA/GSFC (Systems Development and Analysis Branch) 

Tne University of Maryland (Computer Sciences Department) 
Computer Sciences Corporation (Flight Systems Operation) 

The goals of the SEu are (1) to understand the software de- 
velopment process in the GSFC environment; (2) to measure 
the effect of various methodologies, tools, and models on 
this process; and (3) to identify and then to apply success- 
ful development practices. The activities, findings, and 
recommendations of the SEL are recorded in the Software 
Engineering Laboratory Seri a continuing series of re- 
ports that includes this document. A version of this docu- 
ment was also issued as Computer Sciences Corporation 
document CSC/SD-83/6016. 

The primary contributors to this document include 

Pei-Shen Lo (Computer Sciences Corporation) 

David Card (Computer Sciences Corporation) 

Other contributors include 

Frank McGarry (Goddard Space Flight Center) 

Victor Church (Comp'^ter Sciences Corporation) 

Single copies of this document can be obtained by writing to 

Frank E. McGarry 
Code 582.1 
NASA/GSFC 

Greenbelt, Md 20771 
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ABSTRACT 


This document provides the information necessary to under- 
. stand the Software Engineering Laboratory (SEL) Data *^ase 
Maintenance System (DBAM) . It describes the various ^ >ft- 
ware facilities of the SEL, DBAM operating procedures, and 
DBAM system information. Appendixes provide the relation- 
ships among DBAM components (baseline diagrams) , component 
descriptions, overlay descriptions, indirect command file 
listings,, file definitions, and sample data collection forms. 
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SECTION 1 - INTRODUCTION 


1.1 DOCUMENT ORGANIZATION 

This document is intended to serve as a reference for opera 
tors and programmers involved in Software Engineering Labo- 
ratory (SEL) data base maintenance activities. Section 1 
provides an overview of the data base and the various soft- 
ware facilities of the SEL. Section 2 describes in detail 
the operation of the SEL Data Base Maintenance System 
(DBAM) , and Section 3 discusses the programming and imple- 
mentation considerations of DBAM. Appendix A contains base 
line diagrams; Appendix B, component descriptions; 

Appendix C, overlay description files; Appendix D, indirect 
command file listings; Appendix E, file definitions; and 
Appendix F, sample data collection forms. The reader is 
assumed to be generally familiar with the Digital Equipment 
Corporation PDP-11/70 computer and the RSX-llM operating 
system, the environment in which DBAM operates. 

1.2 SOFTWARE ENGINEERING LABORATORY OVERVIEW 

The primary objective of the SEL is to collect and maintain 
a data base for the use of managers and researchers. The 
data are used to analyze the software development process, 
to monitor the progress of ongoing projects, and to provide 
information to development project members. A significant 
body of software has been developed to facilitate this task 
The SEL DBAM, which provides interactive facilities for the 
management of collected SEL data, is the principal subject 
of this document. Two related systems are discussed in the 
following subsection. They are explained in detail in Ref- 
erences 1 and 2 and more briefly in Section 1.3. 

1.3 RELATED SOFTWARE 

Two DBAM-related software packages are described in this 
subsection. They are the Profile Reporting System and the 
Source Analyzer Program. Both systems are operational on a 
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PDP-11/70 computer under the RSX-llM operating system# 
although some preprocessing is required on other machines. 
The SEL data base is stored online to the PDP-11/70. The 
relationships of all software are shown in Figure 1-1. 

The Profile Reporting System (PRS) ‘provides formatted list- 
ings and summaries of the data base contents. Plots are 
also available for some data. PRS reports are distributed 
for review by managers, project leaders, and researchers. 
These reports facilitate the quality assurance of data col- 
lected from completed projects and generate information for 
personnel of active projects. 

The Source Analyzer Program (SAP) enumerates occurrences of 
specific features in FORTRAN source cc-.e (e.g., statement 
types) . Input is usually in the form of a tape prepared on 
the machine used by the development team. SAP produces a 
sequential file of the data generated; this file is later 
processed by a DBAM function (see Section 2.4.4) 

1.4 DBAM/DATA BASE OVERVIEW 

DBAM is organized into five functions; create, archive, 
restore, update, and compress. The update function is 
further subdivided into 13 subfunctions, each of which ’al- 
lows the operator to add to or modify data in a specific 
file type interactively. This updating may be done as part 
of the regular data collection procedure or in response to 
requests for changes by reviewers. Subfunctions may operate 
in any of three modes: add, change, or delete (except as 

noted in Section 2.3). The create, archive, restore, and 
compress functions are utilities affecting the entire range 
of data base files. They are discussed in Sections 2.5, 

2.6, 2.7, and 2.8, respectively. Two frequently used 
special-purpose utilities, UPDSFG and UPDMFN, are included 
in DBAM. They are described in Sections 2.9 and 2.10, 
respectively. 


1-2 
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Figure 1-1. Organization of OBAN and Related Systems 








Seven types of data are collected and maintained in the data 
base : 

• Project, Project information is collfC"red on a 
by-project basis. It is usually provided by the 
project managers. 

e Form . The project leader and the developers fill 
out forms describing their activities; this infor- 
mation is referred to as "form" data. 

e SAP . SAP data are generated by the Source Analyzer 
Program. 

• Code . Many nonnumeric data fields are encoded 
(i.e., a numeric code is substituted for character 
values) . The equivalence between numeric codes and 
character values is code information. 

• Status . Status data include file names, record 
counts, and access dates for all data base files. 

• Comments . Comments can be associated with some 
forms but are stored separately. 

• Computer . Computer data include computer usage 
accounting information and source code usage infor- 
mation from the development machine. 

The data are distributed among several files. Each file 
type corresponds to a record format. There may be multiple 
occurrences of files of a particular file type, as outlined 
in Section 3.2. The data collection forms and data base 
files are described in detail in Reference 3. Software and 
data base files are cataloged under separate User Identifi- 
cation Codes (UICs) . 

DBAM includes an interactive update program (editor) for 
most file types. The relationship between files and DBAM 
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proqrams managing those files is defined in Table 1*1. The 
inteiractive update programs are described in detail in Sec- 
tion 2. 
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Table 1-1. Relationship of DBAM Programs to Data 
Base Files 


Type of File 

Abbreviation 

Type of Data 

Update 

Program 

Accounting Information 

ACC 

Computer 

UPDACC 

UPDSFG 

Component Information 

GIF 

SAP/code 

UPDCIF 

UPDSFG 

UPDMFN 

Comments 

CMT 

Comments 

a 

Change Report Form 

CRF 

Form 

UPDCRF 

UPDSFG 

Component Summary Form 

CSF 

Form 

UPDCSF 

UPDSB’G 

Component Status Report 

CSR 

Form 

UPDCSR 

UPDSFG 

Subjective Evaluations 
Directory 

DIR 

Code 

UPDDIR 

Encoding Dictionary 

ENC 

Code 

UPDENC 

Estimated Statistics 

EST 

Project 

UPDEST 

Growth History 

HIS 

Computer 

UPDHIS 

UPDSFG 

Phase Dates (Header) 

HDR 

Project 

UPDHDR 

Run Analysis Form 

RAF 

Form 

UPDRAF 

UPDSFG 

Resource Summary Form 

RSF 

Form 

UPDRSF 

UPDSFG 

SAP Output 

SAP 

SAP 

UPDCIF 

Subjective Evaluations 

SEF 

Project 

UPDSEF 

File Name and Status 

STS 

Status 

UPDSTS 


^See Section 3.1.2. 
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Tilt' lollowimi i onn contain inntrurl ionn aiui noton on 

t l>o i>p»M ation ot' tho >SK[. intoractivo liat in.n intonanco pro- 
Otam:;. Section tints oporat iona I rest r ict lonn , and Soc- 

tion ' done t i '.'OS typ«*n ot oiiot monnavion. Soction 1^.4 
do;*,ci i tn‘i'. intoiactivo npda^ino ot Uu» data lutno. Tl»o main- 
tonanoo nt i t it ion aio doner ibmi in Sootionn tluoiutti 2.10. 

Tti«» oompMtor in annnmod to ho avaiVahto and t ho data haso 
altoavly imUatlod in thono instruct ionn. 

riu' PHAM tiyiUoin n t'ntiMOvi t>y louviinn on tho niP-11 70 witit 
Hid 1204, i I and oi-ttoi inn ‘‘dSKLllhS". I’iio operator in then 
prompted tot a timet ion and ronponvtn with ono of Uto tollow- 
i nq f u nc t i o n cod o n : 


Ku n ej^ i on j-'odo 


Poncr ipt ion 


UPPATK 


dRPATK 


AUCH IV 
RKSTOR 


COMPRKSa 

IIPOSFU 


IIPDMFN 


STOP 


At town intoiactiv'o update of data bane 
files. Tito operator will be prompted for 
tho file typp« The file typos and subse- 
quent operatinq instructions are described 
in Section 2.4. 

Initializes all files and required header 
records for a new proV/ct (Section 2.5). 

Makes a tape copy of data base tiles (Sec- 
tion 2.6). 

Recovers the data bane from a backup tape 
and the transaction files (Section 2.7). 

Compresses data bases tiles (Section 2.8). 

Updates all status fields in a selected 
data base file to a particular value (Sec- 
tion 2.9). 

Updates the FORTRAN module function value 
for all records of a given Component In- 
formation File (Section 2.10). 

Terminates execution of DRAM. 
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Alternatively, any program can be invoked directly by an 
experienced operator, as indicated in the specific program 
(function) descriptions. 
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2.2 OPERATING RESTRICTIONS 
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The following restrictions apply to concurrent use of DBAM 
file and program resources; 

• No other interactive updates can be made while an 
update of the Encoding Dictionary is in progress. 

• Information (last access date and record count) 
stored in the File Name and Status File may become 
inaccurate if other files are updated while the 
File Name and Status File is being updated. 

• Component names cannot be validated for a project 
whose Component Information File is in the process 
of being updated. 

• No other DBAM programs should be operated while a 
create, archive, restore, or compress operation is 
in progress. 

• No more than one copy of each DBAM* program may be 
in use at any time. 
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2 . 3 MESSAGES 


The following four classes of messages may be c^isplayed dur- 
ing execution; 

• Prompt . These messages terminate with •’(X)*>"# 
where "X” is a FORTRAN format specification, or a list of 
allowable responses separated by "/"• Data or a decision is 
required of the operator. 

• Informational . Messages beginning with '•+++" ad- 
vise that some action has occurred (e.g., record-added) or 
that some condition exists (e‘.g., operation in progress). 

No immediate operator response is required. 

• Error . Messages beginning with '•***” advise that 
some intended action has not occurred or that an undesirable 
condition exits. Examples include "file already in use," 
"validation error," and "record not found." The operator 
should reexamine previous input and assumptions about the 
data. This message is usually followed by a prompt for a 
corrective actio' . 

• Severe Errors . Messages starting with "*** RMS" 
indicate that a hardware, software, or operation error has 
occurred that may affect the program execution. These 
errors should be reported to the Data Base Administrator. 

He or she will correct the problem or refer it to the appro- 
priate support personnel. These errors are numbered and may 
be interpreted by examining Table A-2 of RMS-11 MACRO-11 
Programmer's Reference (Reference 4) . The Data Base Admin- 
istrator o'ill determine when processing may be resumed. 
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2.4 INTEHACTIVE UPDATE PROGRAMS 
2.4.1 INTRODUCTION 

The interactive update programs can be classed into five 
groups based on the type of files accessed and the organize 
tion of OBAM. The characteristics of these program groups 
are as follows: 

• Update Data Base Header and Summary Files 

Data do not come from the forms shown in Ap- 
pendix F, but from other paper records 

Only one file of each kind exists 

Programs: UPDSTS, UPDENC, UPDEST, UPDHDR, 

UPDSEF, and UPDDIR 

• Update Complex Data Files 

- Data come from forms shown in Appendix F 

One file of each type exists for each project 

May have multiple comments per record 

Records must be displayed in several segments 

ADD mode prompts field by field 

Changes require two responses (field identifi 
cation and new value) 

Programs: UPDCRF and UPDCSF 

• Update Simple Data Files 

Data come from forms shown in Appendix F (ex- 
cept the Growth History, which is on other 
paper records) 

One file of each type exists for each project 

One or no comments per record 

Records are small enough to be displayed in 
one segment 
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- ADD mode prompts for data in one group (on one 
line) 

- Changes may be made with one response (field- 
id*value) 

Programs: UPDHIS, UPDCSR, UPDRAF, and UPDRSF 

• Update Component Information File (CIF) 

Optionally reads SAP file to update CIF records 

Must be used to assign component names to com- 
ponent codes 

Other capabilities are the same as simple data 
files 

Program: UPDCIF and UPDMFN 

• Update Record Status Flags 

Updates status flag fields of entire data file 

Changes require two responses (file identifi- 
cation and new status value) 

Program: UPDSPG only 

Program activities are divided into three modes: ADD new 

records, CH/'NGE existing records,^ and DELETE existing 
records. Program activity proceeds in three hierarchical 
steps or levels: select mode, identify record, and execute 

mode activity. Mode selection is accomplished by specifying 
the first letter of the mode (e.g.. A) in response to the 


^Changes ^o an existing record are made by first identifying 
the field to be changed. Each field is tagged with a two- 
character code. This code is indicated in the field title 
in the data display by ” symbols next to the characters 
comprising the code. Codes are read top to bottom, then 
left to right. Programs vary in whether or not the new 
value may be entered on the same line as the field code 
(see the following subsections) . 
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prompt for mode. The programs automatically cycle between 
the last two steps until the operator intervenes.^ 

The last access date and record count on the record for the 
accessed file (in the File Name and Status File) are auto- 
matically updated. A sequential transaction file is main- 
tained for each form type. The afterimage of each updated 
record is copied to it with a transaction code (A » ADD, 

C * CHANGE, D ■ DELETE) , and the current date. 

The individual programs are described in detail in Sec- 
tions 2.4.2 through 2.4.14. Figure 2-1 shows the general 
outline of activity in the interactive update programs. 


^The control-Z character may be entered in response to any 
prompt to terminate the program. Entering •'/*" will cause 
a return to the program driver (which prompts for mode) . 
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2.4.2 UPDATE COMPONENT SUMMARY FORM (UPDCSF) PROGRAM DE- 
SCRIPTION 


Pi-ogram Function . UPDCSF supports the interactive addition, 
deletion, and editing of records in the Component Summary 
Form (CSP) File. 

Data :^sed . The following data setr are accessed: 


Data Set 

Encoding Dictionary 

CSF File (by project) 

CIF File (by project) 

Comments (CMT) File (by 
project) 

CSF Transaction File 
File Name and Status File 


Operation - 

Read only 

Read, write, update, delete 
Read only 

Read, write, delete 

Write (append) only 
Read, update 


Program Invocatio n. Execution of UPDCSF may be initiated by 
either logging on with UIC [204,3] and entering ”$UPDCSF” or 
logging on with another UIC and entering "@ [ 204 , 3] UPDCSF" . 

Program Operation . Program activities are divided into 
three modes: ADD, CHANGE, and DELETE. Within these func- 

tions, other activities are divided into hierarchical levels. 
Program levels are summarized as follows: 

Level Description 

1 Select mode (ADD/CHANGE/DELETE) 

2 Identify CSF record (project, form number) 

3 Perform activity (mode) 

These activities are described below. 


• Select Mode (Level 1) . One of three modes may be 
selected; ADD new records, CHANGE existing records, or 
DELETE existing records. Mode selection can only be made at 
this level. 
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• Identity-Record (Level 2) . A valid project and 
form number must be supplied in response to the prompts. 
Entering "S” (stop) returns the program to the "select mode” 
prompt. A carriage return, in response to the "identify 
project" prompt, retains the previous response to that 
prompt. 

• ADD Mode (Level 3) . The message "duplicate record" 

appears if the form number supplied is already defined for 
this project. Otherwise, the operator is prompted for each 
field in turn. Prompts are also made for corrections to any 
input errors that have been detected. A carriage return may 
b*' '‘nt'rod for any field for which a is not available. 

The completed record is then displayed. The data display 
should be carefully examined, and any discrepancies from 
what was intended should be noted. The record can be cor- 
rected later in the CHANGE mode. The prompt "enter x" ap- 
pears next. The operator should respond with an "X" if the 
record is acceptable. If the data are marked acceptable, 
the operator is prompted for comments, and the record and 
comments are added to the data base. The program then re- 
turns to the "identify record" prompts (level 2). 

• CHANGE Mode (Level 3) . The message "record not 
found" is displayed if the specified record is not defined 
for this project. Otherwise, the record is displayed in 
five segments. The values in the current display may be 
changed by entering the code corresponding to the field in 
response to the prompt "enter code for field." The operator 
is then prompted for a new value for that field. Entering a 
carriage return in response to the "enter code" prompt 
causes the next record segment to be displayed, or, in the 
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case of the last segment, causes a prompt for **disposition** 
to appear. Four responses are possible: 

• LIST--List the current record; prompt again for 
disposition 

e EDIT--Rfesu:r .0 : iiting (as in paragraph above) 
e EXEC — UjvddC:: *:he record on the data base; exit 

• (Carriage return only] --Make no changes to the 
original record; exit 

The last two responses return the program to the CSF "iden- 
tify record" prompts (level 2) after completing the speci- 
fied action. 

DELETE Mode (Level 3} . The message "not found" is displayed 
if the record is not defined for this project. Otherwise, 
the record is deleted and an appropriate message is dis- 
played. The program returns to the "identify record" 
prompts (level 2) . 

End of Session (Level 1) . Specifying "S" (stop) in response 
to the prompt for function terminates the UPDCSF session. A 
summary of transactions is displayed. 
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2.4.3 UPDATE CHANGE REPORT FORM (UPDCRF) PROGRAM DESCRIPTION 

Program Function . UPDCRF supports the interactive addition, 
deletion, and editing of records in the Change Report Form 
(CRF) Files. 


Data Sets Accessed . The following data sets are accessed; 
Data Set Operation 


Encoding Dictionary 
CRF File (by project) 

CIF File (by project) 

CMT Pile (by project) 

CRF Transaction File 
File Name and Status File 


Read only 

Read, write, update, delete 
Read only 

Read, write, delete 
Write (append) only 
Read, update 


Program Invocation . Execution of UPDCRF may be initiated by 
either logging on with UIC [204,3] and entering “gUPDCRP” or 
logging on with another UIC and entering [204 , 31 UPDCRF" . 

Program Operation . Proceeds as in UPDCSF (Section 2.4.2). 
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2.4.4 UPDATE COMPONENT INFORMATION PILE (UPDCIP) PROGRAM 
DESCRIPTION 


Program Function . UPDCIP supports the interactive addition, 
deletion, and editing of the CIFs. Optionally, CIF records 
can be updated from the SAP output. 


Data Sets Accessed . The fol 

Data Set 

Encoding Dictionary 
CIF File (by project) 

SAP Output File 
CIF Transaction File 
File Name and Status Pile 
Error message data set 


lowing data sets are accessed: 

Operation 

Read only 

Read, write, update, delete 
Read only 

Write (append) only 
Read, update 
Write only 


Program invocation . Execution of UPDCIP may be initiated by 
either logging on with UIC [204,3] and entering ''@UPDCIF” or 
logging on with another UIC and entering "9 [204,3] UPDCIP". 


CIF Data Structure . CIF records may be divided into two 
parts: an area that is filled with values supplied by SAP 

and an area that is filled with values collected elsewhere 
(PANVALET level, function, origin, etc.). The latter data 
are displayed first, on a single line (segment). The SAP 
data are displayed on two lines (subsequent segments) . 

Program Operation . Program activities are divided into four 
modes; ADD, CHANGE, and DELETE and READ from the SAP Output 
File. The READ mode is fully automatic. Records from the 
SAP Output File are matched (by component name) with CIF 
records; then the SAP data are copied into the CIF record. 
The record on the SAP Output File is then deleted. No 
checks are made for duplicate names or records in the SAP 
Output File or for already filled fields in the CIF records. 
The last SAP record read (for a component) supersedes all 
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proviouo in SAP-r.uppl iod fipldn. Unmatched SAP recorvis 

remain in the SAP Output File for later processing. Compo- 
nent names in SAP records that were not matched with a CIF 
record are listed *n an external data set as well as dis- 
played on the terminal. The operator is offered an oppor- 
tunity to list this data set at the end of the session. 
Proqram activltier> in the other modes are divided into re- 
curring layers: 

Leve l Description 

1 Select mode ( ADD/CHANOE/DRLETF/RBAD) 

(There are no further levels tor read 
modo ) 

J Identify project 

1 Identify CIF record (component name) 

4 Perform mode activity (supply values) 

These activities ace described below. 

• Select Mode (Level 1) . Four modes are available: 
ADO new records, CHANCE existing records, DELETE existing 
records, and READ (and update existing data) from SAP Output 
File. Mode selection can only be made at this level. 

• Identify Project (Level 2) . In response to a 
prompt, the operator must specify the project name to iden- 
tify and open the proper CIF. The operator may respond to 
the "identify project" prompt with a project name, an "S," 
or a carriage return. "S" terminates the current mode and 
returns the program to the "select mode" prompt (level 1). 
Entering a carriage return causes the last response (project 
name) to this prompt to be reused. A ay other response is 
verified as a project name by comparison with the Encoding 
Dictionary . 

• Identify Record (Level 3) . The operator must ex- 
plicitly specify the component name in response to ttie 
"identify record" prompt (level 2). Furthermore, a CIF 
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record must .nlready exist t'or that component if the mode is 
CHANOE or DELETE; a CIF record for that component cannot 
aLreadv' exist if the mode is ADD. An error returns the pro- 
gram to the "identify project" prompt (level 2). 

• ADD Mode (Level 4) . Three different ii v'«lays of 
data field titles are presented. The oper'-t'- ” v/ supply 
values for some, none, or all the fields by onv.ering a value 
directly below the field to be filled. The data fields 
identified in the last two displays can be filled from the 
SAP Output File by the READ function. The operator usually 
skips these fields when addinq new records (by entering. a 
carriage return only). Input values are validated imme- 
diate Lv, and tlu’ operator is offered the opportunity to cor- 
rect any errors detected in this line. The record is then 
added to the data base, and the program activity transfers 
to the "identify project" prompt (level 2). 

• CHANGE Mode (Level 4) . Each of the three segments 
of data is displayed in turn. After each display, the oper- 
ator is prompted for a field to change and a new value. The 
field and value are validated immediately, and the operator 
is offered an opportunity to correct any errors detected. 
Entering a carriage return only advances the program to the 
next segment. After the last segment, the operator is 
prompted for the disposition of the revised record. Enter- 
ing "X" (execute) causes the cor respoml ing data base record 
to be replaced with the revised record. Entering "L" (list) 
transfers program activity to the beginning of the change 
sequence (including displays) for this record. A null re- 
sponse (carriage return) aborts the transaction; the data 
base is not changed. Following an "X" or null response, 
program activity transfers to the "identify project" prompt 

( level 2) . 
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• PKLKTK MoJ»* (Love I 4) . Ident i f icAt ion of a VAlid 
ooinponont nAme results in the deletion of the related record, 
ProqrAm Activity returns to the "identify project" prompt 
(level 2). 

• Knd of Session (L-.*vel 1) . S pec i f y i tiq " S " (stop) in 
response to the "iselect mode" prompt (level 1) terminates 
prouiAm execution. A summarv of transactions is displayed. 
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2.4.5 UPDATE COMPONENT STATUS REPORT (UPDCSR) PROGRAM 
DESCRIPTION 


Program Function . UPDCSR supports the interactive addition, 
deletion, and editing of the Component Status Report (CSR) 
File. 

Data Sets Accessed. The following data sets are acc’SGvit 


Data Set 

Encoding Dictionary 
CSR Pile (by project) 

GIF File (by project) 

CSR Transaction File 
File Name and Status File 


Operation 

Read only 

Read, write, update, delete 
Read only 

Write (append) only 
Read, update 


Program Invocatio n. Execution of UPDCSR may be initiated by 
either logging on with UIC [204,3] and entering "©UPDCSR" or 
logging on with another UIC and entering [204 , 3] UPDCSR" . 

CSR Data Structure . Any given CSR form may generate several 
CSR records. Each record corresponds to a horizontal line 
of data from the CSR form. The fields of a CSR record are 
divided into the following three areas for access and dis- 
play purposes: 


• CSR form-identification area--Pro ject , form, pro- 
grammer, phase, and date are fields common to all 
CSR records derived from the same form. All fields 
are required. 

• CSR component-status area--Sequence number; compo- 
nent; and design, code, and test hours are unique 
within the group of records making up a form. 

• CSR other-activity area--Other-activity name and 
hours may be filled instead of the component-status 
area. The component-status and other -activity 
areas cannot both be filled. 
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P rogram Operation , Program activities are divided into 
three modes: ADD, CHANGE, and DELETE. Within these modes, 

other activities are organized into hierarchical levels. 
Activity in a given level is terminated by entering ''S'' 

(stop) at the entry point for that level, or by providing 
the program with the necessary information to proceed. (An 
exception is the lowest level, which may be exited only by 
entering carriage returns in response to ail prompts.) "S" 
always returns the program to the next higher level. The 
program levels are summarized as follows: 

Level Description 

1 Select mode (ADD/CHANGE/DELETE) 

2 Identify CSR form (project, programmer, 

date, form number) 

3 Identify CSR record (sequence number) 

4 Perform mode activity 

These activities are described belor*. 

• Select Mode (Level 1) . Three modes are available: 
ADD new records, CHANGE existing records, and DELETE exist- 
ing records. Mode selection can only be made at this level. 

• Identify Form (All Modes, Level 2) . All fields 
must be supplied in the ADD mode. Only project and form 
number need be supplied for the CHANGE and DELETE modes. 
Entering "S" returns the program to the "select mode" prompt 
(level 1). A carriage return may be entered to retain the 
last project entered as the current project. 

• ADD Mode (Levels 3 and 4) . The user may enter a 
specific sequence number or enter a carriage return to use 
automatic sequencing option. Automatic sequencing incre- 
ments the sequence number by 1 or sets it to 1 if no se- 
quence number has previously been entered. If the sequence 
number has already been used with this form number, a 
"duplicate record" message is displayed. "S" may be entered 
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to return to the "form identification" prompts. Respondinq 
"A" will bypass subsequent number prompts and data titles 
(for fast data entry). 

Idf?nt i f icat ion of a valid sequence number produces a display 
of the component-status area field titles. The operator 
enters values (where available) for the fields below the 
dashed line. The TAB key may be used to skip blank fields. 
Entering a carriage return instead of a component name at 
this point produces a prompt for the other-activity area. 

The operator responds to this by entering the other-activity 
name (up to eight characters) and the hours separated by an 
equal sign (e.o., = l ;i . 4 " ) . Entering a carriag*’ re- 

turn at this point aborts the transaction and returns the 
program to the "identify record" (sequence number) prompt. 
The operator is prompted for corrections to any input errors 
detected. 

• CHANGE Mode (Levels 3 and 4) . The operator may 
enter a specific sequence number or "S" to stop. A carriage 
return results in the default sequence number "|il" being 
used. If the indicated sequence number is not found for the 
specified form number, the message "record not found" is 
displayed. Responding "A" causes all records of this form 
to be displayed. (The program returns to the "identify 
form" prompts (level 2),) 

Cuce an existing record is identified and retrieved, it is 
displayed. The operator is then prompted for the field to 
be changed and the value to be used. These should be en- 
tered in the following format: "code»value , " where code is 

the two-letter code for the field (indicated by "+" in the 
display titles) and value is the component name (if appro- 
priate) or a decimal number (for hours). The other-activity 
area may be changed by specifying "OA=name=value" , where 
name is the activity name (up to eight characters) and value 



is a decimal number. Note that inserting data in the other- 
activity area ot a record that contains information in the 
component-status area results in the loss of the component- 
status data. The operator is prompted for corrections to 
any input errors oetected. Entering a carriage return in 
response to the prompt for field and value terminates edit- 
ing of that record. 

The operator is then prompted for the disposition or tne 
record. Four responses are possible: 

• LIST--List the current record: prompt for disposi- 

tion appears again 

• EUIT"-Reinitiate editing (as in paragraph above) 

• EXEC--Update the record on the data base; exit 

• (Carriage return only] --Make no changes to the 
original record; exit 

The first two responses return the program to the "disposi- 
tion" prompt. The last two responses return the program to 
the CSK "identify form" prompts (level 2) after completing 
the specified action. 

• DELETE Mode (Level 3) . The operator may enter a 
specific sequence number or "S" for stop. A carriage return 
results in the default sequence number ")til” being used. 

If the indicated sequence number is not found for the speci- 
fied form number r the message "record not found" is dis- 
played. If the record is located, the message "deleted" 
appears (the record has just been deleted) . Responding "A" 
causes all contiguous records of this form to be deleted. 

The program returns to the "identify form" prompts (level 2) . 

• End of Session (Level 1) . Specifying "S" in re- 
sponse to the prompt for mode terminates the UPDCSR session. 

A summary of transactions is displayed. 
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2.4.6 UPDATE RUN ANALYSIS FORM (UPDRAF) PROGRAM DESCRIPTION 

Program Function . UPDRAF supports the interactive addition, 
deletion, and editing of the Run Analysis Form (RAF) Files. 

Data Sets Accessed. The following data sets are accessed: 


Data Set 

Encoding Dictionary 
RAF File (by project) 

GIF File (by project) 

CMT File (by project) 

RAF Transaction Pile 
Pile Name and Status File 


Operation 

Read only 

Read, write, update, aelete 
Read only 

Read, write, delete 
Write (append) only 
Read, update 


Program Invocation . Execution of UPDRAF may be initiated by 
either logging on with UIC (204,3] and entering "(^urDRAF” or 
logging on with another UIC and entering [ 204, 3] UPDRAF" . 

RAF Data Structure . Any given RAF may generate several RAF 
records. Each record corresponds to one horizontal line of 
data from the form. The fields of an RAF record are divided 
into three areas for access and display purposes: 


• RAF identification area--Pro ject, form number, pro- 
grammer, and computer are fields common to all rec- 
ords of the same form. All fields are required. 

• RAF data area--Other fields define the specific run 

• Comment area--Maintaineo in a separate file. 


Program Operation . Proceeds as in UPDCSR (Section 2.4.5). 
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2.4.7 UPDATE RESOURCE SUMMARY FORM <UPDRSF) PROGRAM 
DESCRIPTION 


Program Function . UPDRSF supports the interactive addition, 
deletion, and editing of records in the Resource Summary 
Form (RSF) Files. 


The following data sets are accessed: 

Operation 


Data Sets Accessed . 

Data Set 

Encoding Dictionary 
RSF File (by project) 

RSF Transaction File 
File Name and Status File 


Read only 

Read, write, update, delete 
Write (append) only 
Read, update 


Program Invocation . Execution of UPDRSF may he initiatea by 
either logging on with UIC [204,3] and entering '^i^UPDRSF” or 
logging on with another UIC and entering [ 204 , 3) UPDRSF" . 

RSF Data Structure . Any given RSF form may generate several 
RSF records. Each record corresponds to one horizontal line 
of data from the form. The fields of an RSF record are 
divided into two areas for access and display purposes: 


• RSF identification area->Form number and project 
are common to all records of a form, both fields 
are required. 

• RSF data area--Other fields define a resource and 
its utilization. 


Program Operation . Proceeds as in UPDCSR (Section 2.4.5). 
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2.4.8 UPDATE GROWTH HISTORY PILE (UPDHIS) PROGRAM 
DESCRIPTION 

Program Function . UPDHIS supports the interactive addition, 
deletion, and editing of the Growth History (HIS) Piles. 

Data Sets Accessed . The following data sets are accessed: 

Data Set Operation 


Encoding Dictionary 
HIS File (by project) 

HIS Transaction Pile 
File Name and Status Pile 


Read only 

Read, write, update, delete 
Write (append) only 
Read, update 


Program Invocation . Execution of UPDHIS may be initiated by 
either logging on with UIC [204,3] and entering ''(^UPDHIS” or 
logging on with another UIC and entering ”(§ [204,3]UPDHIS". 

Program Operation . Program activities are divided into 
three modes: ADD, CHANGE, and DELETE. Activities within 

these modes are divided into hierarchical levels. Activity 
on a level is terminated by entering "S'* in response to the 
first prompt at that level. Program levels are as follows: 

Level Description 

1 Select mode (ADD/CHANGE/DELETE) 

2 Identify project 

3 Identify date of data 

4 Perform mode activity 


These activities are described below. 


• Select Mode (Level 1) . Three modes are available: 
ADD new records, CHANGE existing records, and DELETE exist- 
ing records. Mode selection can only be made at this level. 

• Identify Project (Level 2) . The operator must sup- 
ply a project name or enter ”S” (stop) . A null response 
causes the previous project name to be reused. ”S" returns 
program activity to the "select mode" prompt. 
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• Identify Date of Data (Level 3) . The date must be 
supplied. The add mode accepts the date from the same line 
as the rest of the data. DELETE and CHANGE modes require 
that the date be entered in response to the specific prompt 
for that field. 

• ADO Mode (Level 4) . A line of data titles is dis- 
played. Values for these fields should b« entered in a 
single line below the titles. Errors are then reported, and 
the operator is provided an opportunity to correct the er- 
ror. No record is added to the data base without a complete 
and correct date. The operator continues to be prompted for 
data in this manner until a null date or line is pntered. 

The program then transfers to the "identify project" prompt 

( level 2) . 

• CHANGE Mode (Level 4) . The data for the specified 
date are displayed, if found; otherwise, a message is dis- 
played and the program transfers to level 2. The operator 
is prompted for the field to be changed and the replacement 
value. Responses should take the form "code*value, " where 
code is the two-character code for the field and value is an 
acceptable value for that field. Errors are reported imme- 
diately, and the operator is given an opportunity to correct 
any error. Entering a null response results in a prompt for 
record "disposition." Entering "X" (execute) causes the 
changed record to replace the old record in the data base. 
"L" (list) transfers activity back to the display of data. 

A null or blank response causes the transaction to be ig- 
nored (no change will be made to the data base) . After null 
or "X", the program transfers to the "identify project" 
prompt (level 2). 

• DELETE Mode (Level 4) . The record for the speci- 
fied date is deleted if found; otherwise, a message is dis- 
played. The program returns to the "identify project" 
prompt (level 2) . 
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• Fnd of Session (Level 1) . Specifying ”S" in re- 
sponse to the prompt for mode terminates the UPDHIS session. 
A summary of transactions is displayed. 
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2.4.9 UPDATE FILE NAME AND STATUS FILE (UPDSTS) PROGRAM 
DESCRIPTION 


Program Function . UPDSTS supports interactive deletion and 
editing of existing records in the File Name and Status 
(STS) File. (Records may only be added to the File Name and 
Status Pile through the CREATE utility.) 


Data Sets Accessed . The following data seLs are accessed; 


Data Set 


Operation 


Encoding Dictionary Read only 

File Name and Status File Read, update, delete 

ProgruH Invocation . Execution of UPDSTS may be initiated by 
either logging on with UIC [204,3] and entering "@UPDSTS'' or 
logging on with another UIC and entering [ 204 , 3 ] UPDSTS” . 

Program Operation . The operator is prompted for the project 
name and file type (qualifier). The record for this file is 
retrieved from the data base and displayed. Then the opera- 
tor is prompted for the field to be changed and the value to 
use. Responses should take the form ”code»value, ” where 
code is the two-character code for the field and value is an 
acceptable value for the field. Errors are reported, and 
the operator is given an opportunity to provide correc- 
tions. Entering a null or blank response results in a 
prompt for disporiit ion. Allowed responses are "L", list and 
resume editing; ”X”, complete the transaction by updating 
the data base; "D”, complete the transaction by deleting the 
record from the data base; and "S", discard this transac- 
tion. Exercising any of the last three options (X, D, S) 
returns the program to the "project name" prompt. Entering 
a null response for the project name causes the next sequen- 
tial record in the file to be retrieved. Entering "S" ter- 
minates the program. 
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2.4.10 UPDATE ENCODING DICTIONARY (UPDENC) PROGRAM DESCRIP- 
TION 

Program Function . UPDENC supports the interactive addition, 
deletion, and editir»g of records on the Encoding Dictionary 
(ENC) . 

Data Sets Accessed . The following data sets are accessed; 

Data Set Operation 

Encoding Dictionary Read, write, update, delete 

File Name and Status File Read, update 

Program fnvocation . Execution of UPDENC may be initiated by 
either logging on with UIC [204,3] and enteririg ''0UPDENC' or 
logging on with another UIC and entering "0 [ 204, 3 ] UPDENC” . 

Program Operation . The operator must first identify the 
mode/function in response to that prompt. "A” for odd, ”C” 
for change, and ”S” for stop (terminate program) are allowed 
responses. The operator is prompted for the code type 
(category of codes) and item name (eight-character abbrevia- 
tion) . The operator is prompted for a description of the 
entry in the ADD mode. The previous description is dis- 
played, and the operator is prompted for a replacement in 
the CHANGE mode. Entering "D” in response to this prompt 
causes the record to be deleted. A null or blank response 
leaves the record unchanged. Any other value is accepted as 
the new description. (Because of the nature of the Encoding 
Dictionary, only the description is a changeable field.) 

The program then returns to the "code type” prompt. 
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2.4.11 UPDATE ESTIMATED STATISTICS FILE (UPDEST) PR0GRAi4 
DESCRIPTION 

Program Function . UPDEST supports the interacMve addition, 
deletion, and editing of the Estimated Statistics (EST) File. 

Data Sets Accessed . The following data sets' are accessed: 

Data Set Operation 

Encoding Dictionary Read only 

Estimated Statistics File Read, write, update, delete 

Program Invocation . Execution of UPDEST may be initiated by 
either logging on with UIC [204,3] and entering "^UPDEST" or 
logging on with another UIC and entering ”3 [204 , 3 ] UPDEST” . 

Program Operation . Program activities are divided into 
three modes: ADD, CHANGE, and DELETE. Activities within 

these modes are divided into three hierarchical levels. 
Program levels are summarized below. 

Level Description 

1 Select mode (ADD/CHANGE/DELETE) 

2 Identify project 

3 Perform mode activity 

• Select Mode (Level 1) . Three modes are available: 
ADD new records, CHANGE existing records, and DELETE exist- 
ing records. Mode selection can only be made at this level. 
”S” (stop) di splays a summary of tran • .ctions, then termi- 
nates the ptogram. 

• Identify Project (Level 2, All Modes) . The opera- 
tor must supply a project name or enter "S”. ”S” returns 
program activity to the "select mode" prompt (level 1) . 

• ADD Mode (Level 3) . Several sets of data titles 
are displayed consecutively. Each is followed by a prompt 
for data. Values should be entered in a single line imme- 
diately below the field to which they are to be applied. 
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The operator is notified of any errors detected and is given 
an opportunity to correct them. The newly constructed rec- 
ord is displayed after all data have been entered. The pro- 
gram then returns to the "identify project" prompt (level 2) . 

• CHANGE Mode (Level 3) . The data for the specified 
project are displayed, if found; otherwise, a message ap- 
pears and the proqram returns to the "identify project" 
prompt (level 2). The operator is prompted for the field to 
be changed and the value to use. Responses should take the 
form "code=value , " where code is the two-character field 
code and value is an acceptable value for this field. 

Entering a null or blank response results in a prompt for 
’disposition." Allowed responses are "L", list and resume 
editing; "X", complete the transaction by updating the data 
base; and null (blank) response, discard this transaction. 
Exercising either of the last two options returns the pro- 
gram to the "identify project" prompt (level 2). 

• DELETE Mode (Level 3) . The record for the speci- 
fied project is deleted, if found; otherwise, a message is 
displayed. The program returns to the "identify project" 
prompt (level 2). 
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UPPATM SUHJKCriVK KVAI.UATIONS K II.K (IIPOSKF) 
PHSv'UIPriON 


PRlHlKAM 


Pi vHi I ,m . UPPi^FF luippoitr. t ht‘ iiUoivU'tivo 

ih'lotion, and pditinn nt lovoidn on tho SuPioot ivo FvaUia- 
tivmn FlU? (t^KF). 


loll ovtf i nvi d a t a so t s a i o aooo s sod : 
O£orat ion 


• Pat a Sot 

Fnood i no Plot iona i y 

Sub loot I VO Fvaluat ions 
Piit'otory Filo 

Subiootivo Fval uat ions. Filo 


Uoad only 
Koady only 

Ko.\d, wi’ifo, upilato, dolot»‘ 


K *1? _J L ^ • Fsooutioii ot UPPSFF may bo itntiatod by 

oithoir loouit'O on with UK' [.'P4,.l| aiul ontoi inu "ifU'PPSFF" oi 
louoino on with anothoi UlC and ontorino ''«' ( ^04 , .1 1 i'PPSFF" . 

P r oyt t‘ am Opo v a t i o n . P r oo r a m a o t i v i t i »' s a r o d i v i d t' d i n t o 
tluoo modos: APP, OHANC.F, and PKl.FTF. Aotivitios within 

thoso modos ato dividod itUo throo lUo la i \'h ioa I lovols. 
Piootam lovols aio summari.:od bolow. 


liO V o I Po s c i' i p t i o n 

1 So loot modo (APP CHANdF PFLFTF.) 

2 Tdontify pioioct 

.1 Po t* f o i‘ m in o d o a o t i v i t y 

• So loot mode (Lovol 11 . Throo mod os aro avviilablo: 
APP now roooi'ds, I'MANOF osistinq rooords, and PELKTK oxist- 
inq rooords. Modo oolootion can only bo mado at this lovol. 
"S” (stop) displays a summary ot t ransact ions , thon tormi- 

n a t o s t h o p r o q r a m . 

• I d on t i f y P r o j oc t ( l.o vo I 2, All Mod o s ) . The opora- 

tor must supply a projoct namo or ontor "S". ”S" roturns 

proqram activity to tho "soloct modo" prompt (lovol 1). 


ORIGINAL PAGE IS 
OF POOR QUALITY 

• ADD Mode (Level 3) , Titles of measures of differ- 

ent categories are displayed consecutively. Each category 
may contain two or more lines. Each title line display is 
followed by a prompt for data. Values should be entered in 
a single line immediately below the field to which they are 
to be applied. The operator ’.3 notified of any errors de- 
tected and is given an oppo •. i. jn i ‘n correct them. After 
each record is entered inco the SEE, the operator is noti- 
fied by the message DATA RECORD XX ADDED/' where XX is 

the data record sequence number. After all seven records of 
a given project have been entered, the program returns to 
the "identify project" prompt (level 2) . 

• CHANGE Mode (Level 3) . After entering the CHANGE 
mode, the program first prompts for the name of the category 
of measure to be changed. The operator must supply a cate- 
gory name tha*t is valid (see Appendix A of Reference 3) . 
Otherwise, the message "RECORD NOT FOUND" is displayed and 
the program returns to the prompt for the name of the cate- 
gory of measure to be changed. If the category is valid, 
the data for the specified category of a given project are 
displayed. The operator is then prompted for the name of 
the field to be changed. After responding with a code name, 
the operator is prompted for a new value. The operator 
should respond with an acceptable new value for this field. 
Allowed responses for the field to be changed, besides the 
actual field name, are "L", list and resume editing; "X", 
complete the transaction by updating the SEF; and "S", dis- 
card this transaction and return to the prompt for the name 
of the category of measure to be changed. 

• DELETE Mode (Level 3) . All seven records of a 
specif ied ■ project are deleted; otherwise, a message "***DATA 
RECORD XX NOT POUND" (where XX is the data record sequence 
number) is displayed. The program returns to the "identify 
project" prompt (level 2) . 
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2.4.13 


UPDATE SUBJECTIVE EVALUATIONS DIRECTORY (UPDDIR) PILE 
PROGRAM DESCRIPTION 


Program Function . UPDDIR supports the interactive addition, 
deletion, and editing of records on the Subjective Evalua- 
tions Directory (DIR) Pile. 

Data Sets Accessed . The following data sets are accessed: 

Date Set Operation 

Subjective Evaluations Read, write, update, delete 

Directory File 

File Name and Status File Read, update 

Program Invocation . Execution of UPDDIR may be initiated by 
either logging on with UIC ( 204,3) and entering ''QUPDDIR" or 
logging on with another UIC and entering "§[ 204 , 3 ] UPDDIR" . 

Program Operation . The operator must first identify the 
mode/function in response to that prompt, "A" for add, "C" 
for change, "D" for delete, and "S" for stop (terminate pro- 
gram) are allowed responses. In all modes (except STOP),, 
the operator is prompted for the code-type. (With an entry 
of "S", the program returns to the "mode/function" prompt.) 

In the ADD mode, the operator is prompted for a description 
of the entry. In the CHANGE mode, the existing record is 
displayed and the operator is prompted for replacement 
values. In the DELETE mode, the "code-type" entered by the 
operator is deleted. In all modes, completion of the func- 
tion is noted, and the program returns to that function's 
"code-type" prompt. With an entry of "S" to the "mode/ 
function" prompt, the STATUS. HDR is updated accordingly and 
a count of the functions performed is displayed prior to the 
program ending. 


2-33 


8207 


ORIGINAL PAGE IS 
OF POOR QUALITY 


2.4.14 UPDATE PHASE DATES FILE (UPDHDR) PROGRAM DESCRIPTION 

Program Function . UPDHDR supports the interactive addition, 
deletion, and editing of records on the Phase Dates (HDR) 
File. 

Data Sets Accessed . The following data sets .r:- arcessed; 

Data Set Operati''>n 

Encoding Dictionary Read only 

Phase Dates (Header) File Read, write, update, delete 

Program Invocation . Execution of UPDHDR may be initiated by 
either logging on with UIC [204,31 and entering "QUPDHDR” or 
logging on with another UIC and entering [204, 3] UPDHDR”. 

Program Operation. Proceeds as in UPDEST (Section 2.4.11). 
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2 . 5 CREATE NEW PROJECT FILES (CREATE) UTILITY DESCRIPTION 


ProgL.'^in Function , CREATE initializes required records in 
the Encoding Dictionary and File Name and Status File and 
creates data base files for a new project. 


Data Sets Accessed , The following data sets are accessed; 
Data Set Operation 


Indirect command files Read only 

Temporary data sets Read, write, delete 

Encoding Dictionary Read, write 

File Name and Status File Read, write 


CIF 

File 

(by 

project) 

Define 

only 

(by 

DEF 

Utility) 

CMT 

File 

(by 

project) 

Define 

only 

(by 

DEF 

utility) 

CRF 

File 

(by 

project) 

Define 

only 

(by 

DEF 

utility) 

CSP 

File 

(by 

project) 

Define 

only 

(by 

DEF 

utility) 

CSR 

File 

(by 

project) 

Define 

only 

(by 

DEF 

utility) 

HIS 

File 

(by 

project) 

Define 

only 

(by 

DEF 

utility) 

RAF 

File 

(by 

project) 

Define 

only 

(by 

DEF 

utility) 

RSF 

File 

(by 

project) 

Define 

only 

(by 

DEF 

utility) 


Program Invocation , Execution of CREATE may be initiated by 
either logging on with UIC [204,3] and entering "^CREATE” or 
logging on with another UIC and entering (204, 3] CREATE", 


Program Operation , The program first prompts for the proj- 
ect name. It then attempts to add the project name to the 
Encoding Dictionary and to create records in the File Name 
and Status File for the project files that are to be created. 
Any errors are reported to the operator. The operator must 
decide, on the basis of the messages received, whether or 
not to proceed with the actual file creation.. Any reported 
error is sufficient cause to terminate CREATE, If the oper- 
ator chooses to terminate CREATE, care should be taken to 
delete the records that have just been added to the Encoding 
Dictionary and the File Name and Status File using UPDENC 
and UPDSTS, respectively. 


ORIGINAL PAGE IS 
OF POOR QUALITY 


2.6 ARCHIVE DATA BASE FILES (ARCHIV) UTILITY DESCRIPTION 

Program Function . ARCHIV makes a tape copy of the entire 
data base or of a list of files specified by the user. 


Data Sets Accessed. The following data sets are accessed: 


Data Set 

All or part of data base 
File Name and Status File 
Encoding Dictionary 
Magnetic tape 


Operation 

Read only (by BCK utility, 
Read, update, write 
Read only 

write only (by BCK utility) 


Program Invocation . Execution of ARCHIV may be initiated by 
either logging on with UIC (2C4,3] and entering ''QARCHIV or 
logging cn with another UIC and entering 1204, 3 J ARCHIV*. 


Program Operation . The operator is first reminded to ready 
the tape from the console and specify, the necessary command 
format. When this has been done, the operator should re- 
spond to the prompt for files to be saved by entering "ALL” 
or "LIST". The tape identification is then requested. This 
should be the same alphanumeric string used in the INI/MOU 
commands. if "ALL" was specified, all data sets under 
UIC [204,1] are copied to the tape. Otherwise, the program 
prompts for file names until a null response is entered. 
These files are verified against the File Name and Status 
File for accuracy, the last access date is reset, and the 
files are copied to tape. The File Name and Status File is 
updated before any data sets are copied under the "ALL" 
option. 


See RSX-11 Command Language Manual (Reference 5) for de 
tails about the INI and MOU commands. 
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2.7 RESTORE DATA BASE FILES (RESTOR) UTILITY DESCRIPTION 


Program Function . RESTOR recovers all or a list of data 
sets stored on a tape and reestablishes them under UIC 
(204,1) . 


Data Sets Accessed. The following data sets ate accessed: 


Data Set 

Magnetic tape 
Transaction Files 
Recovered data base 

Encoding Dictionary 
File Names and Status Pile 


Operation 

Read only (by RST utility) 
Read only 

Read, write, update, delete, 
write (by RST utility) 

Read only 

Write only 


Program Invocation . Execution of RESTOR may be initiated by 
either logging on with UIC [204,3] and entering ”@RESTOR” or 
logging on with another UIC and entering ”9 [204, 3] RESTOR” . 


Program Operation . The operator is first reminded to ready 
the tape from the console and specify the necessary command 
format. When this has been done, the operator should re- 
spond to the prompt for "files to recover" by entering "ALL" 
or "LIST". Specifying "LIST" causes the program to prompt 
for and recover files by name. Specifying "ALL" recovers 
the entire contents of the tape. The operator is then 
prompted for the versions of the Transaction Files to be 
merged with the data base. The operator should determine 
these files before beginning RESTOR by selecting the last 
versions in existence before the date of the archive 
(backup) tape copy from which the recovery (restore) is 
being made. 
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2,8 COMPRESS DATA BASE FILES (COMPRESS) UTILITY DESCRIPTION 

« 

Program Function . COMPRESS compresses user-specified data 
base files. It first defines new versions of the files and 
then copies all records from the old versions to the new 
versions of the files. 

Data Sets Accessed . The following data sets are accessed: 

Data Set Operation 

Desired data base files Read, write 

File Name and Status File Read only 

Program Invocation . Execution of COMPRESS may be initiateo 
by logging on with UIC [204,3] and entering "^COMPRESS” or 
logging on with another UIC and entering ”@[204,3]COMPRESS". 

Program Operation . After "8COMPRESS" is entered, the user 
is given the prompt F* COMPRESSF [S] : to which the. user can 
enter the name of the data base file to be compressed. (The 
"[S]" indicates that a character string is expected.) Wild- 
cards (*) may be used to specify all projects, all file 
types, or both. For example, F* COMPRESSF [S ]:*. RAF would 
cause all Run Analysis Form Files to be compressed. 

Some file characteristics, such as the file-extension quan- 
tity, vary depending on whether the file is considered 
"active" or "inactive." This is indicated by the current 
data base file version number. Any file with a version num- 
ber less than octal 100 is considered active; all other 
files are inactive. (Most data base files are inactive.) 
Version numbers may be changed if necessary by using the PDP 
PIP command. 

HELP may be entered in response to the COMPRESS prompt for 
user help information. 
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2.9 UPDATE STATUS FLAG (UPDSFG) UTILITY DESCRIPTION 


Program Function . UPDSPG updates the status flag field of 
every record in a selected data base file to a particular 
value. UPDSPG cannot be used to update the status flags in 
header files. 


Data Sets Accessed: The following data sets arf, accessed: 


Data Set 

Desired data base file 
Encoding Dictionary 
Transaction Piles 


Operation 

Read, update 
Read only 

Write (append) only 


Program Invocation . Execution of UPDSPG may be initiated by 
either logging on with UIC [204,3] and entering ”@UPDSFG” or 
logging on with anoth<»'r UIC and entering [204, 3] UPDSPG" . 

Program Operation . After the UPDSPG utility is entered; the 
operator is prompted first for the project name. The opera- 
toc must supply a valid project name or enter "S" (stop) . A 
null response causes the previous project name to be reused. 
"S" stops program execution. If an invalid project name is 
given, the program displays an error message on the terminal 
and prompts for the project name again. If a valid project 
name is entered, the program then prompts for the file type. 
The operator must enter a valid file type or "S" (stop). 

"S" or a null response returns program activity to the 
"project name" prompt. "ACC", "CIP", "CMT", "CRP", "CSP", 
"CSR", "HIS", "RAP", and "RSF" are valid file types. If an 
invalid file type is entered, an error message is displayed 
on the terminal and the program prompts the operator for the 
file type again. 


If both project name and file type are valid, help informa- 
tion on the allowed status values is displayed, and the 
operator is prompted for the new status value. The operator 
must respond with one of the allowed values; otherwise, an 
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error message la displayed and the prompt Cor the status 
value is given again. The following status values are 
allowed: 

Status Value De scr ipt ion 

1 Data unchecked 

2 Data hand-checked 

3 Data verified by usage 

After the program updates the status flag Cor all records in 
the selected file to the new value, a summary report is 
printed on the terminal. The information displayed contains 
the file name, total number of records processed, and the 
new status value. In addition, the old status values in the 
file and the numo^r of records having each old status value 
are displayed. After the summary report is displayed, the 
program returns to the prompt for the project name. 
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2.10 UPDATE THE MODULE FUNCTION OF THE COMPONENT INFORMATION 
FILE (CTF) UTILITY (UPDMFN) DESCRIPTION 

Program Function . UPDMFN computes and updates the FORTRAN 
module function value for records of a given CIF in the SEL 
data ba.-e. 


Data Sets Accessed. The following data sets are accessed: 


Data Set 

Encoding Dictionary 
CIF File (by project) 
CIF Transaction File 


Operation 

Read only 

Read, update 

Write (append)* only 


Program Inv^'^cation . Execution of UPDMFN may be initiated by 
either logging on with UIC (204,3] and entering "9UPDMFN'' or 
logging on with another UIC and entering "0 (204, 3] UPDMFN” . 

Program Operation . After the UPDMFN utility is entered, the 
operator is prompted for the project name. The operator 
must enter a valid project name or ”S”. for stop. "S” stops 
program execution. A null response also stops program exe- 
cution. When an invalid project name is entered, the pro- 
gram displays an error message on the terminal and prompts 
for project name again. 

When the project name is valid, the program performs the 
following activities without operator intervention: For 

each record in the CIF, when the module function field is 
blank and the number of executable statements is greater 
than zero, the module function value is computed and stored 
in the appropriate field of the record. Otherwise, the mod- 
ule function value in the record is not changed. After all 
records in the specified CIF have been processed, a summary 
report, which contains the number of records read, number of 
records changed, and number of errors encountered, is dis- 
played on the terminal. After the summary report is dis- 
played, the program returns to the» prompt for another 
project name. 
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SECTION 3 - SYSTEM DESCRIPTION 


The DBAM system is composed of the programs and data sets 
described in the following subsections. 

3.1 SYSTEM ORGANIZATION 

System activities are organized onto three levels: 

• Funct ion--The type of activity to be performed 
(e.g., UPDATE, or ARCHIV) 

• Subf unction--The application of that activity to a 
specific file (e.g., update component information 
file (UPDCIF)) 

• Mode--The particular operation in progress on a 
file (e.g., ADD, CHANGE, or DELETE) 

Only the UPDATE function has subfunctions (e.g., UPDCIF or 
UPDENC) , and only the UPDATE subfunctions have modes (e.g., 
ADD or CHANGE) . Six other utility functions are available 
in addition to the UPDATE function. Each utility function 
and UPDATE subfunction is an independently executable mod- 
ule. (Their operation was described in detail in Sec- 
tions 2.4 through 2.10.) The executable modules of DBAM are 
composed of indirect command files and FORTRAN subroutines 
as indicated below. 

3.1.1 INDIRECT COMMAND FILES 

The highest level of system control is exercised by the \.i- 
direct command files (Figure 3-1). The activities they per- 
form include selection of the function to be performed, 
selection of the type of file, initiation of execution of 
FORTRAN programs, and integration of RMS utilities. Indi- 
rect command files are not compiled; they are interpreted 
code and system directives. Minimally, the call to the exe- 
cutable task image associated with each function is imbedded 
in an indirect command file of the same name. Listings of 
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Figure 3-1. SEL DBAM Indirect Command File Organization 





















the DBAM indirect command files are presented in Appendix D. 
Other services may also be connected by these indirect com- 
mand files. 

3.1.2 INTERACTIVE UPDATES 

The special nature of the Record Management System (RMS)- 
indexed file structure prevents SEL files from being ac- 
cessed by the usual sequential methods. Interactive update 
programs take advantage of the RMS-indexed feature to pro- 
vide fast access to the data. Every record in a file is 
identified by a unique field (primary key) and possibly by 
other fields (alternate keys) . These keys are used to mani- 
pulate RMS-indexed records directly. 

The 13 UPDATE subfunctions update the data base. Fig- 
ures A-1 through A-13 in Appendix A illustrate the baseline 
diagrams for these subfunctions. The module functions are 
described in Tables B-1 through B-13 and in Table B-20 in 
Appendix B. Three modes (ADD, CHANGE, DELETE) within each 
'subfunction are supported for all SEL files except the Com- 
ments File. The additional capability of reading data from 
the SAP Output File is also available in the UPDCIF function. 

Comments can only be added or deleted; they cannot be 
changed. Comments are not logically independent of the 
forms to which they pertain, and so they are updated as part 
of a form update. No separate UPDATE function is available 
for Comment Files. 

3.1.3 FILE MAINTENANCE UTILITIES 

Four utilities--CREATE, ARCHIV, RESTOR, and COMPRESS-- 
support the maintenance of the global data base structure. 
These utilities are indirect command files that use RMS sys- 
tem utilities in addition to application programs to perform 
their function. Descriptions of the utilities follow (the 
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RMS Utility used is noted in parentheses) , Figures A-14 
through A-17 in Appendix A illustrate the baseline diagrams 
for these functions. The individual module functions are 
described in Tables B-14 through B-17 and in Table B-20 in 
Appendix B, Reference 6 describes the use of the RMS util- 
ities. 

The CREATE (DEP) uti ity enters a new project name in the 
Encoding Dictionary, creates all data files specific to that 
project, and adds records for those files to the File Name 
and Status File. The six Header Files are the only data 
sets that must be defined by separate procedures. 

The ARCHIV (BCK) utility makes a tape copy of all or a list 
of data base files. The "last backup date" field in the 
File Name and Status File is updated for every file saved. 
The Transaction Files are also reinitialized if the entire 
data base is archived. The date and tape identification of 
every ARCHIV transaction is recorded on a log data set. 

The RESTOR (RST) utility recovers all or a list of data sets 
from a tape. Previous versions of Transaction Files are 
merged with the reinstalled files if "ALL" is specified. 

The COMPRESS (DEF, IFL) Utility compresses the data base 
files by sorting the file indexes and reformatting the data 
into contiguous blocks, 

3.1.4 INDEPENDENT UTILITIES 

Two utili ties--UPDMFN and UPDSFG--are included in DBAM to 
perform some special functions. Figures A-18 and A-19 in 
Appendix A illustrate the baseline diagrams for these func- 
tions. The Individual module functions are described in 
Tables B-18, B-19, and B-20 in Appendix B. 

The UPDMFN utility computes and updates the FORTRAN module 
function value for records of specified CIFs. The UPDSFG 


3-4 


O n A 


utility updatt'R tho status flaq field of every record in a 
selected data base file to a particular value, UPDSPG cannot 
be used to update status Claqs in header files. 

3.2 DATA SBT DESCRIPTIONS 

The data sets used by DBAM fall into tlie three groups de- 
scribed below. All files, unless otherwise noted, are lo- 
cated on disk DBl in UIC (204,1). 

3.2.1 DATA BASE FILES 

Data base files contain the information used in the inter- 
pretation and analyses that are the goals of tho SEL. Tho 
files containing descriptions of tho structure of these 
files are presented in Appendix E. The detailed formats of 
the files are presented in Reference 3. All data base files 
are RMS-indexed files with fixed-length, formatted records. 
(The SEF and SAP files are exceptions as noted below.) 

There are six header files in the data base. Three of these 
files contain information describing other files or their 
content: the Encoding Dictionary (ENCODE, HDR) , the File 

Name and Status File (STAT.HDR), and the Subjective Evalua- 
tions Directory File (DIR, HDR) . The other three header 
files contain summary information describing the projects: 
the Phase Dates File (HEADER. HDR) , the Estimated Statistics 
File (EST.HDR), and the Subjective Evaluations Data Pile 
(SEF. HDR), The SEF is the only data base file containing 
variable-length records. 

There are nine "form" data file types in the data base. 

Each project may be represented by up to nine files, one of 
each type. These files are named "pro ject . abv" , where proj- 
ect is the name of the project and abv is the three-character 
file type abbreviation (Table 1-1) . The files contain 
either form, computer, component, or comment data. 
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The SAP Output File is the only sequential organization data 
base tile. This file contains the component data extracted 
from project source code oy tne SAP (Ueference 2) . 

3.2.2 TRANSACTION FILES 

Transaction files receive afterimages of all updates made to 
seven types of form data files. (There is no transaction 
file for either the CMT or Accounting Information (ACC) type 
of form data file.) A transaction file has the same format 
as the corresponding form data file but has additional bytes 
to specify the type of transaction (A ■ ADD, D * DELETE, 

C = CHANGE) and the date of the transaction. These files 
are namea "[ 204 , IJ TRANS . abv" , where abv is the three- 
character form type (Table 1-1‘. These files have fixed 
length and sequential formats and are the only files asso- 
ciated with the SEL data base that are located on disk DBO. 

3.2.3 OTHER FILES 

Several files are used by the maintenance utilities to pass 
data among indirect command files, programs, and RMS util- 
ities. CREATE uses ''(204, 3] PRONAM.DAT'* to hold the name of 
the project for which files are being created. ARCHIV and 
RESTOR use "[ 204, 3] FILNAM.DAT" to save the specification of 
files to be archived or restored. A log of ARCHIV transac- 
tions is maintained on " [ 204 , 3] BCKLOG. DAT" . Error messages 
generated by UPDCIF while processing SAP data are saved on 
" [204, 3JMESSAGE.SAP”. All of these data sets have variable- 
length sequential formats. 
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3.3 TASK-BUILD PROCEDURES 


All programs desc;ibed in this document were implemented in 
structured FORTRAN. Consequently, all sources must pass 
through the FORTRAN Preprocessor (FPP) (Reference 7) before 
compilation. The locations of all data sets required to 
prepare a task image (load module) are listed in Table 3-1. 

Table 3-1. Locations of Component Data Sets 


File Type 

Qualifier 

UIC 

« , 

Source 

FPP 

[204,151 

Object 

OBJ 

[204,15] 

Overlay 

ODL 

[204,15] 

Task image 

TSK 

[204,5] 

Indirect task builder com- 
mands 

TKB 

[204,15] 

Task image generation com- 

CMD 

[204,15] 


mands 

The component (subroutine) name is used as the file name of 
the source and object data sets. The program (function) 
name is used as the file name of the task images. Over-lay 
Descriptor Language data set names have the format "XX.ODL” 
and indirect task builder command data set names have the 
format "XX.TKB", where XX is the subsystem prefix 
(Table 3-2) . Task-build options used in preparing task 
images are listed in Table 3-2. Task image generation com- 
mand files perform all precompile, compile, and task build 
operations and have names with the format "XXGEN.CMD” , where 
XX is the subsystem prefix. Appendix C lists the Overlay 
Descriptor Language needed to build these task images. 
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Table 3-2. Task-Build Options for DBAM Functions 

Maximum Number Maximum 

Subsystem Active Files of Units Buffer Size 


Program 

Prefix 

(ACTFIL) 

(UNITS) 

(MAXBUF) 

UPDSEF 

SE 

3 

13 

5 78 

UPDEST 

ES 

2 

12 


UPDHDR 

HD 

2 

12 


UPDHIS 

HI 

4 

12 


UPDRSF 

RS 

4 

13 


UPDRAF 

RA 

4 

14 


UPDCSR 

CT 

4 

13 


UPDCSF 

CM 

4 

14 

263 

UPDCIF 

Cl 

4 

14 


UPDCRF 

CH 

4 

14 


UPDSTS 

ST 

2 

12 


UPDENC 

EN 

2 

12 


CREPIL 

(CREATE) 

CE 

4 

11 


ARCFIL 

(ARCHIV) 

AR 

4 

11 

263 

RESFIL 

(RESTOR) 

RE 

4 

13 

263 

STS (COM- 
PRESS) 

CO 

1 

1 


UPDDIR 

SD 

2 

1 


UPDMFN 

MF 

3 

3 


UPDSFG 

SF 

4 

3 

263 
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APPENDIX A - BASELINE DIAGRAMS 


Appendix A contains baseline diagrams for the DBAM programs. 
Figures A-1 through A-13 and show the 13 update subfunc- 
tions; Figures A-14 through A-19 show the 6 utility func- 
tions. 

Figure 
Number 


A-1 

A-2 

A-3 

A-4 

A-5 

A-6 

A-7 

A-8 

A- 9. 

A-10 

A-11 


A-12 

Phase Dates (Header) Update Subfunction 

A-13 

Subjective Evaluations Directory File 
Subfunction 

Update 

A-14 

Create Function 


A-15 

Archive Function 


A-16 

Restore Function 


A-17 

Compress Function 


A-18 

Update Status Flag Function 


A-19 

Update the FORTRAN Module Function of 
ponent Information File Function 

the Com 


Title 

Component Summary Form Update Subfunction 
Change Report Form Update Subfunction 
Component Information File Update Subfunction 
Component Status Report Update Subfunction 
Run Analysis Form Update Subfunction 
Resource Summary Form Update Subfunction 
Growth History Update Subfunction 
File Name and Status File Update Subfunction 
Encoding Dictionary Update Subfunction 
Estimated Statistics File Update Subfunction 
Subjective Evaluations File Update Subfunction 
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Figure A-1. Baseline Diagram for Component Summary Form Update 
Subfunction (2 of 1) 





















OELCSF 


ORIGINAL PAGE IS 
OF POOR QUALITY 



4 









































































NEWPRO 




\tU0Z9 



A-6 


Subfunction (2 of 3) 
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Update Subfunction (2 of 3) 
















REDCIF 


OWGlNAt 

OF POOR QUALITY 



A-10 


for Component Information File 





































Hsondn 





A-11 


Figure A-4. Baseline Diagram for Component Status Ref 
Update Subfunction (1 of 3) 































CHOCSH 


ORIGINAL PAGi: m 
OF POOR QUALITY 



A-12 


Figure A-4. Baseline Diagram for Component Status Report 
Update Subfunction (2 of 3) 
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Figure A- 5. Baseline Diagram for Run Analysis Form Update 
Subfunction (2 of 3) 
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Baseline Diagram for Resource Si.mmary Form Update 
Subfunction (1 of 2) 
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Figure A-9. Baseline Diagram for Encoding Dictionary Update Subfunction 















ORIGINAL PAGE IS 
OF POOR QUALITV 





















UPDSEF 



A-23 


11. Baseline Diagram for Subjective Evaluations File Update 











ORIGINAL PAGE IS 
OF POOR QUALITY 






<<<<<<<< 



A-24 


Figure A-11. Baseline Diagram for Subjective Evaluations 
File Update Function (2 of 16) 
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Diagram for Subjective Evaluations File Update 
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Figure A-11. Baseline Diagram for Subjective Evaluations File Update 
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11. Baseline Diagram for Subjective Evaluations Pile Update 
Function (10 of 16) 
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Figure A— 11. Baseline Diagram for Subjective Evaluations 
Pile Update Function (11 of 16) 
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Figure A~ll. Baseline Diagram for Subjective Evaluations 
File Update Function (12 of 16) 
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Figure A~ll. Baseline Diagram for Subjective Evaluations 
File Update Function (13 of 16) 
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Figure A-11. Baseline Diagram for Subjective Evaluations File Ui^date 
Function (16 of 16) 
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Figure A-15. Baseline Diagram for Archive Function 
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Figure A-16. Baseline Diagram for Restore Function 
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Figure A-17. Baseline Diagram for Compress Function 
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Figure A 19. Baseline Diagram for Status Flag Update Function 
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APPENDIX B - COMPONENT DESCRIPTIONS 


Appendix B contains brief descriptions of all components 
written for DBAM. These are organized by subfunction (task 
image; . Those components that arc common to several sub- 
functions are listed in the last table. 


Table 

Number Title 


B-1 

B-2 

B-3 

B-4 

3-5 

B-6 

B-7 

B-8 

B-9 

B-10 

B-11 

B-12 

B-1 3 

B-.L4 

B-15 

B-16 

B-17 

B-18 

B-19 

B-20 


UPDCSF Component Descriptions 

UPDCRF Component Descriptions 

UPDCIF Component Descripcions 

UPDCSR Component Descriptions 

CPDRAF Component Descriptions 

UPDRSF Component Descriptions 

UPDHIS Component Descriptions 

UPDSTS Component Descriptions 

UPDENC Component Descriptions 

UPDEST Component Descriptions 

UPDSEF Component Descriptions 

UPDHDR Component Descriptions 

UPDDIR Component Descriptions 

CREATE Component Descriptions 

ARCHIV Component Descriptions 

RESTOR Component Descriptions 

COMPRESS Component Descriptions 

UPDMFN Component Descriptions 

UPDSFG Component Descriptions 

Recurring Component Descrip- 
tions 


B-1 


ORIQINAL PAGE IS 
OF POOR QUALITY 


Table B-1. UPDCSF Component Descriptions 


Module Description 

ADDCSF ADD mode driver for CSF; controls data 

set access 

APCM*^ Adds comments to comment file 

CHGCSF CHANGE mode driver for CSF; controls 

data set access 

DELCSF DELETE mode driver for CSF; control^'. 

data set access; deletes identified ' 
record 

DSACSF Displays first segment of CSF record 

DSBCSF Displays second segment of CSF record 


DSCCSF Displays third segment of CSF record 

DSDCSF Displays fourth segment of CSF record 

DSECSF Displays fifth segment of CSF record 

DSFCSF Displays sixth segment of CSF record 

DSPCSF Display driver for CSF data 

EMHORB Verifies that a 1-byte field contains 

"E”, "M”, "H'', or a blank 

FLDCSF Prompts for changes and rewrites a CSF 

record 

GETCRF Prompts for and validates the project 

name and form number 

NUCORB Verifies that a 1-byte field contains 

•N", ••U", "C”, or a blank 

PROCSF Constructs and adds a new CSF record 

from operator input 

UPDCSF Update Component Summary Form File 

subfunction driver; selects mode 

VALCSF Passes parameters from validation 

control tables 

VALDTX Validation driver; selects validation 

type 
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Table B-2. tJPDCRF Component Descriptions 


Module 


Description 


ADOCRF 
* CHGCRF 
DELCRF 

DSACRF 

DSBCRF 

DSCCRP 

DSDCRF 

FLDCRF 

GETCRF 

PROCRF 

UPDCRF 

VLACRF 

VLBCRF 

VLCCRF 

VLDCRF 


ADD mode driver for CRF? controls data 
set access 

CHANGE '.node driver for CRF; controls 
data set access 

DELETE mode driver for CRF; controls 
data set access; deletes identified 
record 


Displays first segment of CRF record 

Displays second segment of CRF record 

Displavs third segment of CRF record 

Displays fourth segment of CRF record 

Identifies fields to be changed in the 
CRF record 

Prompts for and validates project name 
and form number 

Drives CRF record updates 

Update Change Report Form File 
subfunction driver; selects mode 

Validates first segment of CRF data 

Validates second segment of CRF data 

Validates third segment of CRF data 

Validates fourth segment of CRF data 


B-3 



Table 0 

Module 

ADDCIF 

CHGCIP 

CO DC IF 

DKLCIF 

DSACIF 
D SBC IF 
DSCCIF 
FLDCIF 

m 

GETCIF 

Move IF 

NAMCIF 

PROCIF 

RE DC IP 

UPDCIF 

VALCIF 

VLACIP 

VLBCIF 

VLCCIF 
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3. UPDCIF Component Descriptions 
% 


Description 

ADD mode driver for CIFj controls data 
set access 

CHANGE mode driver for CIF; controls 
data set access 

Finds an unusea component code in the 
CIF 

DELETE mode driver for CIF; controls 
data set access; deletes identified 
record 

Displays tirst sov^ment oi Ci:' record 

Displays second seijment of CIF record 

Displays third segment of CIF record 

Prompts for changes and rewrites a CIF 
record 

Prompts for and validates project name 
and component name 

Moves data from a SAP record to a CIF 
record 

Reads and validates project name and 
component name from SAP record 

Constructs and adds a new CIF record 
from operator input 

Reads SAP records and matches them with 
CIF records 

Update Component Information File 
subfunction driver; selects mode 

CIF validation driver 

Validates first segment of CIF data 

Validates second segment of CIF data 

Validates third segment of CIF data 
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Table B-4. UPDCSR Component Descriptions 


Module 

Description 

ADDCSR 

ADD mode driver for CSR? controls data 
. set access 

CHGCSR 

CHANGE mode driver for CSK; controls 
data s<^ t access 

DELCSR 

DELETE mode driver for CSR; controls 
data set access; deletes indicated 
record 

DSPCSR 

Display driver for CSR data 

FL'OCSR 

Prompts for changes and rewrites a CSR 
record 

FORCSR 

Displays titles for data part of CSR 
record 

GETCSR 

Prompts for and validates project name 
form number, and date 

HEDCSR 

Displays titles for record 
identification part of CSR record 

PROCSR 

Constructs and adds a new CSR record 
from operator input 

UPDCSR 

Update Component Status Report Pile 
subfunction driver; selects mode 

VALACT 

Validates other-activity field of CSR 
record 

VALCSR 

Validates data fields of CSR record 
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Table B-5. UPDRAF Component Descriptions 


Module 

Description 

ADDRAF 

ADD mode driver for RAF? controls data 
set access 

CHGRAP 

CHANGE mode driver for RAF, controls 
data set access 

DATRAF 

Displays titles for data part of RAF 
record 

DELRAF 

DELETE mode driver for RAF? controls 
data set access? deletes identified 
record 

DSPRAF 

Display driver for RAF data 

FLDRAF , 

Prompts for changes and rewrites an 
RAF record 

GETRAF 

Prompts for and validates project name, 
fo ■“ number, programmer, and machine 

HEDRAF 

Displays titles for record 
identification part of RAF record 

PRORAF 

Constructs and adds an RAF record from 
operator input 

UPDRAF 

Update Run Analysis Form File subfunction 
driver? selects mode 

VALCMP 

Verifies that a character string is a 
valid component name 

VALDTY 

RAF validation driver? selects 
validation type 

VALRAF 

Passes parameters from validation 
control tables 
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Table B-6. UPDRSF Component Descriptions 


Module 

ADDRSP 

CHGRSF 

COMRSF 

DATRSP 

DELRSF 

DSPRSF 

FLDRSF 

GETFRI 

GETRES 

GETRSF 

GETVAL 

HEDRSF 

PRORSF 

UPDRSF 

VALRSF 


Description 


ADD mode driver for RSF; controls data 
set access 

CHANGE mode driver for RSF; controls 
data set access 

Displays titles for RSF computer usage 
data 

Displays titles for RSF manpower and 
other hours data 

DELETE mode driver for RSF; controls 
data set access; deletes identified 
record 

Display driver for RSF data 

Prompts for changes and rewrites an RSF 
record 

Calculates dates at 1-week intervals 
from a starting date 

Prompts driver for RSF add mode 

Prompts for and validates project name 
and form number 

Terminal input driver for RSF ADD mode 

Displays titles for record iden- 
tification area of RSF record 

Constructs and adds a new RSF record 
from operator input 

Update Resource Summary Form File sub- 
function driver; selects mode 

RSF validation driver; selects 
validation type 
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Table B-7. UPDHIS Component Descriptions 

Module 
AHDHTS 

CHGHTS 

OATH IS 
DELHIS 

DSPHIS 
FLDHIS 

PROHIS 

UPDHIS 

VALHIS 


B-8 


Description 


ADD mode driver for HISj controls data 
set access 

CHANGE mode driver for HIS; controls 
data set access 

Displays titles for HIS data 

DELETE mode driver for HIS; controls 
data set access; deletes identified 
record 

Display HIS record 

Prompts for changes and rewrites HIS 
record 

Constructs and adds new HIS record 
from operator input 

Update Growth History File subfunc- 
tion driver; selects mode 

HIS validation driver; selects 
validation type 
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Table 8-8. (JPDSTS Component Descriptions 


Module 

Description 

C HOSTS 

Lower-level driver for STS update 
activities 

DSPSTS 

Displays an STS record 

FLDSTS 

Prompts for changes and rewrites or 
del<»tes an STS record 

GETCOD 

Retrieves the file and project codes 
from the Encoding Dictionary 

GETSTS 

Reads and displays a specified STS 
record 

UPDSTS 

Update File Name and Status File sub- 
function driver; opens and closes data 
sets 

VALSTS 

STS validation driver; selects 
validation type 
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Table B-9. UPDENC Component Description 


Module 

Description 

ADDENC 

Constructs a new ENC record from 
operator input 

CHGENC 

Adds, rewrites, or deletes a specified 
ENC record 

DSPENC 

Displays an ENC record 

FLDENC 

Changes the description field of an 
ENC record 

GETENC 

Process ENC record 

UPDENC 

Update Encoding Dictionary subfunction 
driver 
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Table 

Module 

ADDEST 

CHGEST 

DELEST 

DSPEST 

GETEST 

HOREST 

NUMEST 

UPDEST 

VALE ST 


-10, UPDEST Component Descriptions 

Description 

Constructs and adds a nev/ EST record 
from operator input 

Prompts for changes and rewrites 
an EST record 

Deletes a specified EST record 

Display driver for EST data 

Prompts for and receives EST data 

Displays titles for EST hours data 

Displays titles for EST numeric data 

Update Estimated Statistics File 
subfunction driver 

EST validation driver; selects 
validation type 
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Table 

Module 

ADDSEF 

CHGSEF 

DELSEF 

DSPT/P 

GETFLD 

GETSEF 

RDOIR 

SUM 

UPDSEF 

VALCOD 

VALFLD 

VALSFG 

VFIELD 

VFPNUM 

VLINTG 

VLREAL 

VPARTl 
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•11. UPDSEF Component Descriptions (1 of 8) 


Description 

Constructs and adds new SEF records 
from operator input 

Prompts for changes and rewrites SEF 
records for SEF file 

f 

Deletes records of a given project 
from the SEF file 

Displays title and value of fields for 
a selected category of measure 

Obtains field to be changed and its new 
value and validates it 

Fills the seven SEF records of a given 
project for ADD mode 

Reads one indexed record from the SEF 
directory file 

Computes SUM fo ; a selected category of 
measure 

Updates Subjective Evaluations File 
subfunction driver 

Validates the evaluation code for the 
SEF record 

Validates a fixed decimal number field 
for the SEF record 

Validates status flag value for the 
SEF record 

Validates the value of a given field 
for the SEF records 

Validates a fixed decimal number and 
positions it in the output area with 
given number of implied decimal place 

Validates an integer number field for 
the SEF record 

Validates a given category of measure 
that all fields are real numbers with 
same format 

Validates fields that are 4 bytes long 
for the part one of a given category of 
measure 
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Table B-11. 
Module 

UPDSEP Component Descriptions (2 of 8) 

Description 

VPART2 

Validates fields for the part two and 
above of a given category bf measure 

GETMT 

Obtains and verifies data for the Prac- 
tices and Techniques (MT) category 

SUMMT 

Computes sums on the MT category 

DSPMT 

Displays titles and data for tho MT 
category 

DSPMTl 

Displays first line of titles for the, 
MT category 

DSPMT2 

Displays second line of titles for the 
MT category 

DSPMT 3 

Displays third line of titles for the 
MT category 

GETTS 

Obtains and verifies data for the Tools 
(TS) category 

SUMTS 

Computes sums on the TS category 

DSPTS 

Displays titles and data for the TS 
category 

DSPTSl 

Displays first line of titles for the 
TS category 

DSPTS 2 

Displays second line of titles for the 
TS category 

GETDC 

Obtains and verifies data for the 
Documentation (DC} category 

SUMDC 

Computes sums on the DC category 

DSPDC 

Displays titles and data for the DC 
category 

Dspnci 

Displays first line of titles for the 
DC category 

DSPDC 2 

Displays second line of titles for the 
DC category 

GETAP 

Obtains and verifies data for the Ex- 
perience with Application (AP) category 

SUMAP 

Comoutes sums on the AP category 

DSPAP 

Displays titles and data for the AP 
category 
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Table 

Module 

DSPAPl 

DSPAP2 

GETMG 

SUMMG 

DSPMG 

DSPMGl 

DSPMG 2 

DSPMG3 

DSPMG4 

GETPF 

SUMPF 

DSPPF 

DSPPFl 

DSPPF2 

DSPPF3 

DSPPF4 

GETCP 

SUMCP 


11. UPDSEF Component Descriptions (3 of 8) 


Description 

Displays first line of titles for the AP 
category 

Displays secono line of titles for the 
AP category 

Obtains and verifies dati for the Ef- 
fectiveness of Management (MG) category 

Computes sums on the MG category 

Displays titles and data for the MG 
category 

Displays first line of titles for the 
MG category 

Displays second line of titles for the 
MG category 

Displays third line of titles for the 
MG category 

Displays fourth line of titles for the 
MG category 

Obtains and verifies data for the 
Performance of Team (PF) category 

Computes sums on the PF category 

Displays titles and data for the PF 
category 

Disp' xys first line of titles for the 
PF category 

Displays second line of titles for the 
PF category 

Displays third line of titles for the 
PF category 

Displays fourth line of titles for the 
PF category 

Obtains and verifies data for the 
Complexity of Problem (CP) category 

Computes sums on the CP category 
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Table 

Module 

DSPCP 

DSPCPl 

DSPCP2 

GET IN 

SUMIN 

OSPIN 

DSPINI 

DSPIN2 

GETEX 

SUMEX 

DSPEX 

DSPEXl 

DSPEX2 

GETRA 

SUMRA 

DSPRA 

DSPRAl 

DSPRA2 

GETPR 
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11. UPDSEF Component Descriptions (4 of 8) 


Description 

Displays titles and data for the CP 
category 

Displays first line of titles for the 
CP category 

Displays second line of titles for the 
CP category 

Obtains and verifies data for the 
Internal Influences on Project (IN) 
category 

Computes sums on the IN category 

Displays titles and data for the IN 
category 

Displays first line of titles for the 
IN category 

Displays second line of titles for the 
IN category 

Obtains and verifies data for the 
External Influences on Project (EX) 
category 

Computes sums on the EX category 

Displays titles and data for the EX 
category 

Displays first line of titles for the 
EX category 

Displays second line of 1 Itles for the 
EX category 

Obtains and verifies data for the 
Resources Available (RA) category 

Computes sums on the RA category 

Displays titles and data for the RA 
category 

Displays first line of titles for the 
RA category 

Displays second line of titles for the 
RA category 

Obtains and verifies data for the 
Software Product (PR) category 
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Table B-11. UPDSEF Component Descriptions (5 of 81 


Module 

SUMPR 

DSPPR 

DSPPRl 

DSPPR2 

GETPP 

SUMPP 

DSPPP 

DSPPPl 

DSPPP2 

GETRK 

DSPRK 

DSPRKl 

DSPRK2 

DSPRK 3 

DSPRK4 

GETYP 

DSPYP 

DSPYPl 

DSPYP2 


Description 


Computes sums on the PR category 

Displays titles and data for the PR 
category 

Displays first line of titles for the 
PR category 

Displays second line of titles for the 
PR category 

Obtains and verifies data for the 
Product/Process Performance (PP) 
category 

Computes sums on the PP category 

Displays titles and data for the PP 
category 

Displays first line of titles for the 
PP category 

Displays second line of tides for the 
PP category 

Obtains and verifies data for the Team 
Rank (RK) category 

Displays titles and data for the RK 
category 

Displays first line of titles for the 
RK category 

Displays second line of titles for the 
RK category 

Displays third line of titles for the 
RK category 

Displays fourth line of titles for the 
RK category 

Obtains and verifies data for the Years 
of Professional Experience (YP) category 

Displays titles and data for the YP 
category 

Displays first line of titles for the 
YP category 

Displays second line of titles for the 
* YP category 


B-16 


8207 


ORIGINAL PAGE IS 
OF POOR QUALITY 


Table B-11. 

UPDSEF Component Deecclptions (6 of 8) 

Module 

Description 

DSPYP3 

Displays third line of titles for the 
YP category 

DSPYP4 

Displays fourth line of titles for the 
YP category 

GETYA 

Obtains and verifies data for the Years 
of Applicable Experience (YA) category 

DSPYA 

Displays titles and data for the YA 
category 

DSPYAl 

Displays first line of titles for the 
YA category 

DtJPYA2 

Displays second line o£ titles for the 
YA category 

DSPYA3 

Displays third line of titles for the 
YA category 

DSPYA4 

Displays fourth line of titles for the 
YA category 

GETYE 

Obtains and verifies data for the Years 
of Environment Experience (YE) category 

DSP YE 

Displays title and data for the YE 
category 

DSPYEl 

Displays first line of titles for the 
YE category 

DSPYE2 

Displays second line of titles for the 
YE category 

DSPYE3 

Displays third line of titles for the 
YE category 

DSPYE4 

Displays fourth line of titles for the 
YE category 

GETWP 

Obtains and verifies data for the 
Walston-Felix Model (WF) category 

SUMWF 

Computes sums on the WF category 

DSPWF 

Displays titles and data for the WF 
category 

DSPWFl 

Displays the first line of titles for 
the WF category 
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Table B-11. UPDSEF Comoonent Descriptions (7 of 8) 


Module 

DescriTtion 

DSPWF2 

Displays the second line of titles for 
the WF category 

DSPWF3 

Displays the third line of titles for 
the WF category 

DSPWF4 

Displays the fourth line of titles for 
the WF category 

DSPWF5 

Displays the fifth line of titles for 
the WF category 

DSPWP6 

Displays the sixth line of titles for 
the WF category 

DSPWF7 

Displays the seventh line of titles for 
the WF category 

DSPWF8 

Displays the eighth line of titles for 
the WF category 

VALWF 

Validates fields for the WP measures 

GETPS 

Obtains and verifies data for the Price 
S3 Model (PS) category 

SUMPS 

Computes sums on the PS category 

DSPPS 

Displays titles and data for the PS 
category 

DSPPSl 

Displays first line of titles for the 
PS category 

DSPPS2 

Displays second line of titles for the 
PS category 

GETCO 

Obtains and verifies data for the 
COCOMO Model (CO) category 

DSPCO 

Displays titles and data for the CO 
category 

DSPCOl 

Displays first line of titles for the 
CO category 

DSPC02 

Displays second line of titles for the 
CO category 

GETMS 

Obtains and verifies data for the 
Miscellaneous (MS) category 

DSPMS 

Displays titles and data for the MS 
category 
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Table B-11. 
Module 

UPOSEF Component Desct ipt ior s (8 ot 8) 

Description 

DSPMiil 

Displays the first line of titles for 
the MS category 

DS PMS2 

Displays the second line of titles for 
the MS category 

DSPMS3 

Displays the third line ol title for 
the MS category 

DSPMS4 

Displays the fourtli line ot titles for 
the MS category 

VALMB 

Validates fields for tlie MS measures 

OETSW 

Obtains and verities data for the Code 
Breakdown (SW) category 

DSPSW 

Displays titles and data tor the SW 
category 

DSPSWl 

Displays the first line of titles for 
the SW category 

DSPSW2 

Displays tlie second line of titles for 
the SW category 

DSPSW3 

Displays the third line of titles for 
the SW category 

DSPSW4 

Displays the fourth line of titles for 
the SW category 

DSPSW5 

Displays the fifth line of titles for 
the SW category 

DSPSW6 

Displays the sixth line of titles for 
the SW category 

DSPSW7 

Displays the seventh line of titlfjs for 
the SW category 

DSPSW8 

Displays the eighth line of titles for 
the SW category 

DSPSW9 

Displays the ninth line of titles for the 
SW category 

DSPSWA 

Displays the tenth line of titles for 
the SW category 

VALSW 

Validates fields for the SW measures 
3-19 
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Table B 

Module 

ADDHDR 

CHGHDR 

DATHDR 

DELHDR 

DSPHDR 

EXPHDR 

GETHDR 

HEDHDR 

UPDHDR 

VALHDR 


ORIGINAL PAGE fS 
OF POOR QUALITY 


12. UPDHDR Component Descriptions 

Description 

Constructs and adds a new HDR record 

Prompts for changes and rewrites an 
HDR record 

Displays titles for HDR date data 

Deletes a specified HDR record 

Display driver for HDR data 

Displays titles for extra (unused) 

HDR date fields 

Prompts for and receives HDR data 
for add mode 

Displays titles for non-date HDR data 

Update Phase Dates (Header) File sub- 
function driver 

HDR validation driver; selects 
validation type 
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Table B-13. UPDDIR Component Descriptions 


Module 


Description 


ADDDIR 

CHGDIR 

DELDIR 

UPDDIR 


Constructs a new DIR record from op- 
erator input 

Changes and rewrites an existing DIR 
record as requested by operator input 

Delates an existing DIR record as re- 
quested by operator input 

Update Subjective Evaluations Directory 
(DIR) File subfunction driver; updates 
the Status File (STAT.HDR) 
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Table B-14. CREMATE Component Descriptions 


Module 

Descr iption 

ADDENC 

Constructs a new Encoding Dictionary 
record 

ADDSTS 

Constructs and adds records to the 
File Name and Status File for all files 
to be created for the new project 

CREATE 

(indirect 

file) 

Creates new files 

CREPIL 

(indirect 

file) 

Update Header Files for new project 
driver 

INTENC 

Adds a new record (project) to the 
Encoding Dictionary 
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Table B-15. ARCHIV Component Descriptions 


Module 


Description 


ARCFIL 


ARCHIV 

(indirect 

file) 

BCKDAT 


GETLST 


TRNSET 


Identifies files to be archived and 
tape number 

Copies data base files to tape 


Sets the last backup date to the 
current date for all Pile Name and 
Status File records 

Prompts for file names, verifies them, 
updates the last backup date, and 
writes them to a data set 

Initializes new versions of all Trans- 
action Piles 
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Tahl^ B-16. RESTOR Component Descriptions 


Module 


Description 


RECMER 


RESPIL 

RESTOR 
( indirect 
file) 


Reads a record from a Transaction File 
and performs the indicated update on the 
indicated file 

Merge Transaction Files driver? 
identifies versions to use 

Restore function driver; identifies 
files to be restored 


B-24 


8207 



Table 


Module 


COMPRESS 
( indirect 
file) 

STS 


ORK»'i i.- - . 
POOR QUALITY 


-17. COMPRESS Component Descriptions 


De scription 

Drives compress function; calls DEP 
utility to define new file and then 
calls IFL to copy old file to new file 

Retrieves the number of records of a 
given data base file from the File 
Name and Status File 
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Table B-18. Component Descriptions 


Module Description 

GTPRJ Obtains the project name from the user 

PROCIF Reads records from a given CIF, com- 

putes the FORTRAN module function, and 
stores it back to CIF file 

UPMFUN UPDMFN function driver; computes and 

stores the FORTRAN module function 
value for existing CIF record of a 
given CIF file 
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Table 

Module 

GTPROJ 

GTSTAT 

UPDSFG 

UPSTA7 

VFYFIL 


OF HOUR Q 


<si 


! IT 


ITY 


-19. UPDSFG Component Descriptions 


Description 

Obtains project name from user 

Prompts user for the particular status 
value 

Update Status Flag function driver; 
updates all status fields in a given 
SBL data base file to a particular 
value with one command 

Updates all status fields with a new 
value for a given file and writes 
changes to transaction file 

Verifies the given file type 
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Tible B-20. Recurring Component Descriptions (1 of 2) 


Module 


Description 


ADDCMT 

ALPHA 

CACMT 

CHGCMT 

COCODE 

C0DE2B 

DELCMT 

DNCODE 

DSPCHG 

DSPCMT 

DSPGRP 

PPNUM 

GETPRO 

GETSEQ 

LJUST 

LOG 

NDATE 

NEV7PRO 

NEWPR2 


Adds a comment (one or more records) to 
the comment files 

Verifies that a field is alphabetic 

Display and change comments driver 
for multiple comments 

Deletes an existing comment and re- 
places it with another comment 

Converts a character string to a com- 
ponent code with the Component Informa- 
tion Piles 

Verifies a 2-byte field with the En- 
coding Dictionary 

Deletes a specified comment 

Converts a name to a code or a code to 
a name with the Encoding Dictionary 

Displays summary counts of completed 
transactions 

Reads and displays a specified comment 

Displays all entries of a specified 
type from the Encoding Dictionary 

Verifies that a field has a decimal 
numeric format 

Prompts for and validates the project 
name 

Prompts for and validates or increments 
a sequence number 

Left- justifies a character string 

Writes the current date into the last 
access date and updates the record 
count in a status record 

Verifies that string has a valid date 
format 

Opens and closes project data files 
and the corresponding comment files 

Opens and closes project data files 



T.iblo B-20. Rpcurrinq .Component Doocriptionn (2 of 2) 


Module 

Donor ip t. ion 

NONBI, 

Counts non-blnnk oliairactors in a string 

NIIMEU 

Verifies that a field has a numeric 
format 

PARVAL 

Parses a string into two parts using 
as a delimeter 

TABT.H 

Verifies a 1-byte field with the 
Encoding Dictionary 

TABLK2 

Verifies a repeated 1-byte field with 
the Encoding Dictionary 

XOUB 

Verifies that a byte contains "X” or a 
blank 

YNORB 

Verifies that a byte contains ”Y'*, *'N”, 
or a blank 

ZPILL 

Zero-fills a string 


j 


B-29 


APPKMDIX C - OVERLAY DESCRIPTTON FILES 


This appendix contains the Overlay Descriptor Language needed 
to task-build the task images listed in Table 3-2 (Sec- 
tion 3} . 


Figure 

Number Task Image 


C-1 

C-2 

C-3 

C-4 

C-5 

C-6 

C-7 

C-8 

C-9 

C-10 

C-11 

C-12 

C-13 

C-14 

C-15 

C-16 

C-17 

C-18 


ARCFIL 

CREFIL 

RESFIL 

UPDENC 

UPDSST 

UPDHDR 

UPDSEF 

UPDSTS 

UPDCIF 

UPDCRF 

UPDCSP 

UPDCSR 

UPOHIS 

UPDRAF 

rjPDRSP 

UPDOIR 

UPOMFN 

UPDSPG 
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! OAR.ODL 

• 

; THE OVERLAY STRUCTURE FOR THE DBAM ARCHIVE DATA BASE FILES (ARCKiV) 
j UTILITY (P. LO 10/12/82) 

.ROOT RriSROT-OTSROT-SROOT,OTSALL,RMSALL 
$ROOT: .FCTR C204. 15 WRARCFIL-C204. 153ARTRNSET-C204, 15 :ARBCKDAT-fR00T2 

$R00T2j .FCTR C 204. 15 3ARGETLST-C204. 15:DM2FILL -C 204. 15 ]Df1NONBL -SR00T3 
SR00T3: .FCTR C204. 7TJTM0VE -C204. F ]UTCHAREQ-*ROOT4 
$ROOT4s .FCTR C204. 73UTMATCHS-C204. F3UFRMS lAC/LB 

®LB;Cl.J3Rf1SllM 
8LB:C 1. 13RMS12X 

.END 


1 

2 

3 

4 

5 
€ 
r 

s 

9 
10 
1 1 
12 

13 

14 

15 

) b 


Figure C-1. ARCPIL Overlay Descript.ion File 


OCE.ODL 


; OVERLAY STRUCTURE FOR THE DBAM CREATE NEU PROJECT FILES (CREATE) 
; UTILITY (P. LO 10/12/82) 


fROOT: 

$R00T2 

SR00T3 

$ROOT4 


. ROOT RnSROT-OTSRUT-SROOT. OTSALL. RMSALL 

.FCTR C204, 15 3CECPEFIL-C204. 153CEINTEMC-C204. 15 3DMAP’“NC-yPOOT2 
.FCTR C204. 15 3CEADDSTS-C204. 15 3DMNONBL -C 204. 15 3DM2 - .uL -XR00T3 
.FCTR C204. r 3UTCHAREQ-SR00T4 
.FCTR C204. 7 3UTriATCHS-C204. 73UFRMS lAC/LB 


®LB;i: 1. I 3RMS1 IM 
®LB:C 1. I 3RMS12X 


.END 


4 

5 
C 


I'j 
1 1 

12 
1 "7 

. j 

1 4 
15 
1C 


Figure C-2. CREFIL Overlay Description File 


9 
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9RE . DDL 

OVERLAY STRUCTURE FOR THE DBfin RESTORE DATA BASE FILES (RESTOR) 
UTILITY (P. LO 10/12/82) 

. ROOT RMSROT-OTSROT-$ROOT. CTSALL , RMSALL 
SROOT: .FCTR C204. 15 3REPESF IL-C 204. 15 3RERECMER-C 204. 15 DDMNEUPR2-SR00T2 

fR00T2: .FCTR C204. 15]D11L0G -C204. 15 JDMDNC0DE-SR00T3 

fR00T3: .FCTR C204. T :UTCHAREQ-$R00T4 

*R00T4: .FCTR C204. 7 DUTMATCHS-C 204. T^UTMOVE -C204. 7 3UFRMS lAC/LB 

QLB;C1. 1]RMS11M 
QLB:C 1. 1 3RMS12X 


.END 


1 

? 

i 

4 

5 

6 
t 

3 
9 
10 
1 1 
12 

13 

14 

15 

1 b 


Figure C-3. RESPIL Overlay Description File 


J 0EN.ODL 


; OVERLAY STRUCTURE FOR THE DBAM UPDATE ENCODING DICTIONARY CUPDENC) 4 

; PROGRAM (P. LO 10/12/82) 5 

6 

.ROOT RMSROT-OTSROT-SROOT.OTSALL. RMSALL 7 

SROOT: .FCTR C204. 1S3ENUPDENC-C204. 153ENCHGENC-C204. 15]ENGETENC-”R00T2 3 

SR00T2: . FCTR C 284. 15 ]DMADDEMC-C 204. 15 ]DMLOG -C 204. 15 3ENDSPENC-7R00T3 9 

SR00T3: .FCTR C 204. 15 3DMD3PCHG-SR00T4 10 

SR00T4: .FCTRC204. 7 3UTMATCHS-C 204. 7 3UFRMS lAC/LB 11 

; 1 - 

®LB:C 1. I 3RMS1 IM 13 

®LB:i: 1. nRMS12K 4 

: 15 

.END [£ 


Figure C-4. UPDENC Overlay Description File 


ORIGINAL PAGE !S 
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; OES.ODL 

• OVERLAY STRUCTURE FOR THE DBftli 'UPDATE ESTiriRTEP STATISTICS FILE 
iUPDE 5T:> ppHijPAfl fP. LO 10/12. 'S21 

.ROOT PMSPO'T-OTSPOT-iPOOT.$OD.OTSALL,'^riSALL 
SPOOT: .FCTR C204, 15 3ESUPDEST-C204. 15 ]DMGETPP0-fP00T2 

JP00T2: .FCTP C204. 15 3PMDSPCHG-C 204, 15 DESVALEST-fPUOTS 
•SPOOT3: .FCTP C204, 15 3DI1PAPVAL-C 204. 15 3DmOVEBL-C 204, 15 3DMDMC0DE-£P00T4 
JR00T4: .FCTP C204, T 3UT(1 hTCHS-C 204. 7 3UFRMS IAC/LB-SR00T5 
SP00T5: .FCTR 4<( $8B, SCC, $DD) 

■see: .FCTR C204. 15 3ESCHGEST-C204. 7 3UFRMS lAC/LB 

fCC: .FCTP C204, 153ESAPDEST-C204, 153ESGETEST-C204, 7 3UFRMS lAC/LB 

fDD; .FCTP C 204, 15 3ESDELEST-C 204, 7 3UFRMS lAC.- LB 

$00: .FCTP -HfSRR.-fSS) 

$PR: .FCTP C2G4, 153DMSTSFLG-C204, 153DMLJUST -C204, 15 3Dr'1NIJMER -:fRR2 

$RR2: .FCTR C 204, 15 3DMFPHUM -C 204, 15 3DMYN0RB -C204, 73UTCHARE0 

$SS: .FCTR C204, 15 3ESDSPEST-C 204, 15 3ESNUMEST-C 204, 15 3ESHOPEST-":SS2 

$SS2: .FCTP C204. 153ESLIHEST 

ikB:C 1 . 1 3PMS1 11-1 
(?LB:[ 1, 1 3RMS12X 

. END 


1 


1 

i 

1 

1 

1 

1 

1 

1,' 
I 3 
1 '.' 

21 

B 


Figure C-5. UPDEST Overlay Description Pile 
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i 


; QHD.OPL 2 

: OVEPLPIY STRUCTURE FOR THE PBfln UPDfiTE PHfiSE DOTES FILE (UPDHDR) 4 

; PPOGPOri iP. LO 10" IS 82'» 5 

: C 

.pnOT .tPOOT-PriSPOT-OTSPOT-$BB, JPD. OTSOLL . RMSwLL 
*ROOT: .FCTP C 284. 15 ]HDUPDHPR-C 204. 15 ]DMGETPP0-i:P00T2 S 

fP00T2: .FfTP C 204, 1 5 3PMD3PCHG-C 264. 15 DHDVHLHDR-SROOTS 9 

$R00T3: .FCTP C 204. 15 ]DMPHPVHL~C 204, 15 ]DMMOVEBL-C 204, 15 3PNDNC0DE-IR00T4 10 

■fR00T4: .FCTR C204. 7 ]IJTMATCHS-C204. 7 DUFRMS lAC 'LB 11 

; 12 

fBF: .FCTR FrfBB I , *BB2 . $BB3) 13 

fGei; .FCTR C204. 15]HDCHGHDR"C204. 7 ]UFRMS IHC/LB 14 

fBB2: .FCTR C204. 15DHDADDHDR-C204. 15DHPGETHDR-C204, 7 DUFRMS IOC LB 15 

fBB3: .FCTR C204, 15:HPI'ELHDR-C204. 7]UFPMSIHC LB lb 

: ir 

$DD: .FCTR n fDD 1 . $DD2 . fDD3> 18 

.*DD1: .FCTP C204. 15]DIISTSFLG-C204, 153DMNDATE -C204, 153DMLJUST -JDDIA !'^ 

■fPDlA: .FCTP C204. 15 3DMZSCALE-C204, 73UTCHOREQ 20 

$DD2: .FCTR C204. 153PMCODE2B-C204, 153DMDSPGRP 21 

$DD3: .FCTR C204. 153HDDSPHDP-C204, 153HDHEDHDR-C204. r53HDD0THDR-SDD30 2^^ 

SDDSh: .FCTP C204. 15 3HDE';FHDP I'l; 

QLB;C 1. I 3RMS1 iri.ODL ' 25 

OLB:C 1, I 3RMS12X.ODL 2b 

.END 23 


Figure C-6. UPDHDR Overlay Description File 
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> 

i 9SR.0DL 
i 


t THE OVERLAY STRUCTURE FOR THE tiRAH UPDATE SUBJECTivE EVALUATIONS 
i file (ubdsef) froorah (p. lo ii/is/as) 

I 


. ROOT RM3ROT-OTBROT-*ROOT • *00 > 0T3ALL • RMS ALL 
tROOT : .FCTR C204f 1SISEUPDSEF-C:>04 1 1S3DMUE rpRO-C204t lS3DMbNC0DE-«R00T:; 

»ROOT2t .FCTR C204t IS3SEDSPCHa-C204» 73UTM0VE -C204t 73UTMATCH8-4R00T3 
4ROOT3I .FCTR C204t 1538EVPARTI-C204. 1518EVPART2-C204. 435FRDSEF -*ROOT4 
♦R00T4J .FCTR C204. 153SERDDIR -C204» 73UFRM8IAC/LB-4ROOTS 
«ROOT!i{ .FCTR «<«DD»tCCf»DD> 
t 

•BBI .FCTR C20«f 153SECH0SEF-C204» I33SEDSPTYP-C204f 153SE0ETFLD-4BB1 

•BBi: .FCTR C204.1S3SEVFIELD»C204f 1S3SESUH -C204. iS3SEVLREAL-«EiB3 

»eiEi2t .FCTR «<Eitif)2tEi3.B4iBS.B6tB7.DO>B9rBIOfBUtD12iB13»B14»»Bii3> 

tBEiS: .FCTR *<BIS.BI6.B17«B18fB19.B20.B2n 

Bi: ■ .rCTR C204.153SEIISPAP 

B2: .FCTR C204. 153SEUSPCO 

B3: .FCTR C204.153SEIIGPCP 

B4t .FCTR C204.153SED3PDC 


B5.‘ .FCTR C204.153SEri.<5PEX 

B6S .FCTR C204f 153SEDSPIN 


B7: .FCTR C204.IS3SEBSPM0 

BB: .FCTft C204.IS3SEDSPMS -C204. 153SEVALMS 

B9t .FCTR C204rlS38ED8PNT 

BIO: .FCTR C204»I53SEDSPPF 

Blit .FCTR C204rlS3SEDSPPP 

B12t .FCTR C204f 1S3SEDSPPR 

B13I .FCTR C204.153SEDSPP8 -C204. 153SEVALPS 


B14i .FCTR C204. 1S3SEUBPRA 

B15S .FCTR C204.I53SEDSPRK 

B16: -FCTR 1.204. 153SEDSPSU -C204. IS3SEVALSW 

B17! .FCTR C204.1S3SEDSPTS 

Dial .FCTR C204.1S3SEDSPUF -C204. 153SEVALUF 

B19: .FCTR C204.1S3SED5PYA 

B20: .FCTR C204.I53SEDSPYE 

B2tS • .FCTR ■C204.153SEBSPYP 


*CCi .FCTR C204. I53SEADDSEF-C204.tS3SEOETSEF-C2O4.1S3DM0OVEBL-tCCl 

4CC1S .FCTR C204. 73UFRHSIAC7LB-9CC2 

tCC2> .FCTR *(Cl.C2.C3.C4.CS>CA.C7fC8.C9.C10.CU.C12tCI3.Ct4.»CC3> 

♦CC3S .FCTR •<ClS.C16.Ct7.C18.C19.C20.C21) 

Cli .FCTR C204. 153SEQETAP 

C2i .FCTR r204.1S3SEOETCO 

CJ! .FCTR C204. fS3SE0ETCP 

C4I .FCTR C 204,1 53 SEOETDC 

ca: .FCTR C204,1U3SEUETEX 

C6! .FCTR C204,153SE(iETIN 

C7! .FCTR C204.15TSEGr.TMO 

C8! .FCTR C204.15JSEGETMS 

CV! .FCTR r.204,lSTSEGETMT 

CIO: .FCTR C204.153SEGETPF 

CU! .FCTR C204.15JSEGETPF’ 

C125 .FCTR C204.153SEGETPR 


Figure C-7. UPDSEF Overlay Description File (1 of 2) 
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C13t .FCTR C2O4»1S30EOETF8 

C14i .FCTR CSORrtSlSEOETM 

CtSt .FCTR CnORrlSlSEOETRiT 

CUi .FCTR C.?04»1S]8EOETSU 

C17t .FCTR C204f 1538E0ETTS' 

Clli .FCTR C204ftS3SE0ETUF 

Ctft .FCTR C204f lS3tiE0ETYA 

C20t .FCTR C304»1S38C0ETVE 

C21i .FCTR C204I1S33E0ETVP 

I 

»DDi .FCTR C204iIS36EDELSEF>C204> 73UFRHSIAC/LR 
t 

*QQi .FCTR «RR-«<4SS> 

•RRt .FCTR C204>IS3DHSTSFL0>C204>tS3DRLJU8T -C204>1S3DHNURCR -4RR2 

•RR2t .FCTR C204«1538EVFFNUM-C204f3S38EVALSF0-»RR3 

»RR3t .FCTR C204>1S3SCUALCOD-C204>153SEUALFLD 

> 

4881 .FCTR «<SlfS2*S3>S4»S9»SA>S7t38fS9fS10»SU»S12*313fS14>»SS2> 

«882t .rCTR 4<SlS>St4>S17rSt0>S19»S20>B21) 

Si: .FCTR C204.1533ESUMAF' -C204 »153SEDSPAPl-C204 . lS3riECSPAF2 

S2: .FCTR C204ilS3SEDtiHC01-C204Fi53fiEDSPC02 

S3: .FCTR C204.153SESUMCP -C204 . 153SED8PCPI-C204 . 1333EHSPCP2 

34: .FCTR C204.1S3SESUHDC -C204> lS3SEDSP[iCl-C204f 1S3SEDSPDC2 

SS: .FCTR C204>1538E3U^EX -C204 f 1S38EDSPEX1-C234 • 1S1SEDSPEX2 

SAI .FCTR C204»1S3SE3U4IN -C204» lS38C08PlNl>C204t 1838E38PIN2 

87: .FCTR C204riS38ESUHN0 -C204. 1S38EDSPM01-C204> lS3SED8PMa3-S7A 

S7A: .FCTR C204>1938ED8Pn03>C204il93SED8PM04 

S8I .FCTR C204>i93SED8PI181>C204rt33SEDSPMB2-C204tl93SE08PH82'-8SA 

SeAt .FCTR C204.193SED8PI134 

S9t .FCTR C204»i83SEDSPHTl-C204tl938ED8PRT2-C204f 1938CD8PHT3-89A 

S9At .FCTR C204>1938E8UMHT 

SIO: .FCTR C204.ig3SESUMPF -C204r 153SC0SPPF1-C204> 193REDSPPF2-810A 

SlOA! .FCTR C204>t93SE0SPPF3-C204fl93SEDSPPF4 

31 i: .FCTR C204>153S;:SUMPP -C204.153SED8PPP1-C204f 1S3SEDSPPP2 

312: .FCTR C204.l93Sb:8UMPR -C204> 193SED8PPR1-C204. 193SED3PPR2 

3131 .FCTR C204»153SESUMPS -C204»193Sb'DSPPSl-C204t 1538EDSPPS2 

S14t ..FCTR C204.193SESUMRA -C204. ig3SED8PRAl-C204t 183SEDSPRA2 

319: .FCTR C204. 1838CDSPRK1-C204t 1938ED8PRK2-C204> 1538E0SPRK3-S15A 

S19A: .FCTR C204>ig38ED3F'RK4 

316: .FCTR C204>1938E8SP8U1-C204»183SED8PSU2-C204f 133SE08PSU3-S16A 

316A: .FCTR C204. 193SE03PSU4>C204» 183SEDSPSUS-C204t 153SE:18P8U6-8168 

9168: .FCTR ,';204.193SED3PSU7-C204» 193SEDSP8U8-C204* 183SED8PSU?-S16C 

S16C; .FCTR :204tlS3SE0SPSUA 

317: .FC1R C204.1S38E6UHT8 -C204. 1938EDSPTSl-C204fl53SED8PT82 

318: .FCTR C204f 193SESUNUF -C204f 193SEHSPUF1-C204f 1933ED8PUF2<318A 

SISA: .FCTR C2Q4»1S3HEDSPUF3-C204>1S38ED8PUF4-L204f 1S3SED8PUF8>31BEI 

SI 98 : .FCTR T204 . 15J8ED8PUF6-r204 . ISISEDSPUF 7-C204 . 153SEn«PUFB 

519: .FCTR C204»151SuI'SpyAl-r204.1S3SEDSPVA2~C204.1C3tili:D3PYA2-819A 

S19A: .FCTR C204.1S38SDSPYA3 

S20: .FCTR C204.lHlSEDGPYEi-C204.1S3SEDBPYE2-i:204rl83SED8PYfc:3-a;l0rt 

S20A: .FCTR C204>193SE8SPYE4 

321 : .FCTR C204. 193SEDSPYP1-C204f 193BEriSPYP2-C204. 133SEDSPYP3-S21A 

S21A: .FCTR C204f 153SECISPYP4 

» 

(♦LRtCl. 13RMSUM 

tn.b-: c I . iiRMSi2>: 

r 


Figure C-7. UPDSEF Overlay Description File (2 of 2) 
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ORIGINAl. PAGE IS 
OF POOR QUALITY 


f eST.ODL 

» OVERLAY STRUCTURE FOR THE DBAM UPDATE FILE NAME AND STATUS FILE 
» (UPOSTS) PROGRAM <P. LO 10/12/82) 

) 

, ROOT RMSROT-OTSROT-* ROOT » OTSALL rRMSALL 
DROOT; .FCTR C204f tS3STUPDSTS-C204» 153STCHQ3TS-C204» 153STDSP3T8-«R00T2 
■4iROOT2: .FCTR C204f 123DMPARVAL-i;204» 1S3ST8ETSTS-4R00T3 

JROUTSS .FCTR C204 » 133STGETC0D-i:204 . 123DMDNC0DE-C204» 1S3STFLDSTS-«R00T4 
•».F;00T4: .FCTR f IS3S TVALSTS-C204i 1S3DMNUMER -C204. 153DMNDATE -4ROOTS 
tROOTS: .FCTR C204. 73UTMATCHS-C204r 73UFRMSIAC/LB 
f ' 

OLDtCif 13RMS1*.M 
OLDILlf 13RMS12X 

.END 


Figure C-8. UPDSTS Overlay Description Pile 
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C it 

OF POOR gJALir/ 


; 9CI.0DL 
■ 

; OVERLrtY STRUCTURE FOR THE DBHM UPDATE COMPONENT INFORMATION FILE 
; aiPDCIF^ PROGRAM (P. LO 10-13 A2' 

.ROOT EMCPOT-OTSPOT-fROOT. +TQQ.OTSALL,RMSALL 
IROOT: .FCTR C204. 1 5 ]C lUPDC IF-C 004 . 1 5 3C IGETC IF-C 204. 15 1PMNELJPP0-TP00T2 

fP0nT2: .Fi'TP r."n4. l‘^^r>f'r”-r':'JG-C204. IS^DfCDATE -C 204. 15 .'M’LU., -iKU0T4 
FRIJ0T4: .FCTP [^04. r]IJTBLNN^ -C204. rDUTr^O'’" -C2U4. 7 ]UTMATCHS-fP00T5 
TRDOTU: .FCTt- [_04. riUFFMOInC LB-XFOOTb 
TPOOTb : . FCTP ( i TBB f DP . fEE ^ 

fBB: .FCTP C 20 4 . 15 JC ICHGC IF-C 204, 15 ]C IFLDC IF-C 204. 7DUFPMSIAC uB 

fCC: .FCTR C204. 15 JC IhPPC IF-C 204. 15 3C IPROC IF-C 204. 15 ]C ICODC IF-TCC2 

fCC2; .FCTP C204. 7 3UFPMS lAC 'LB 
fPD: .FCTR C204. 15JCIPELCIF-C204. 7 lUFRMS lAC 'LB 

SEE: .FCTR C204. 15 ]C IPEPC IF-C 204 . 15 3C INAMC IF-C 204. 15 ]C IMOVC IF-iEE2 

SEE2: .FCTR C204. GIPSCT'iPE "C204. 7 ]UFRMSIhC LB 

. NAME ‘n 

SQO: .FCTP '<-r 204 . 1 5 3PMPNC0PE-C 204. 1 5 3PMDSPGPP-C 204 . 1 5 JPMTABLE -SC102 

SQ02: .FCTR C204. 15 ]PMTi-iBLE2-C 204. 152PMSTSFLG-C 204. 15 3C IVALC IF-rQ03 

fOQ3: .FCTR C 204. 15 DDMPAPV'AL-C 204. 153PMLJUST -C 204. 1 5 3PMNUMER -’'004 

4!QLT4: .FCTR C204. 7 DUTCHAPEQ-fQOS 

S005: .FCTP f. i fRP . SSS . S TTi 

SRR: .FCTR C 204, I'd 3C I VLAC IF-C 204. 15 3C IPSAC IF 

$SS: .FCTP C20F. 15 3C IVLBC IF-C 204 153CIPSBC1F 

STT: .FCTR C 204 . 15 ]C IVLCC IF-C 204. l5 1C IPSCC IF 


ALB:C 1 . 1 3PM5I IM 
i?l.B:C 1 . I 3PMS12X 

.END 


Figure C-9. UPDCIF Overlay Description File 
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ORWNAL PR® ra 
OF POOR QURLITV 


OCH.OrL 


OVEPLiV.' ■'TruCTUPP FOP THE DOOM UPDATE CHHNGE PEPOPT FORM (UPPCPF> 
PROGPHM 'F. LO 10^14'S2> 


HFCTK: 
•FCTP: 
FCTP.:: 
: FCTR?! 


.pnnt r^nu. IFlCHUPPr PF-Fn?POT~nT'POT-hiFCTP.'*BFCTR.OTSAL,L.PMSALL 

.M il' L.. 04 . ivJiaibL ii ;■ .[.criL^ - ,:M"p • x: : . rrc. rosi 

[ -.>4. ;r irmn irf'''n-r:n.i. r;. ;.prHG~[ .■' 04 . isidplog - :FCTR 
.Hi n. L.P.J, ’lUTll.rE JUrilHlCHP-CjLU. ,’]tiTHLrtMK - 'FCTR 

.I'l.TF C.M4. l5]I'ICr'HTE -C204. nur-HUSlHC LB 


SDl: 

;FPlrt: 

SDIB: 

■JD2: 

ft>3: 


.FCTR C204. 153CHCHGCPF-C204, 15 3CHFLDCPF-C 204, 15 ITMCHGCMT-CD Ifl 
.FCTR C204. l5]DMr;PCnT-C204. 15 ]I>MI'ELCnT-C 204. 15 DltWDDCMT-T.D IB 
.FCTR C204. nuFRIISIHC LB 

.FCTR C204. l53CHHrDCPF-C204. 15 3CHPR0CPF-C 204, 15 IDMHDDCMT-SDZfl 
.FCTR C204. r]IJFPMSlAC LB 

.FCTR L :04. l5]CHrELCPF-C204. 153I‘IIDELCriT-C204. T^UFRllSIAC LB 


BFCTP: .FCTP C.:04. 15 31'! IDitCOI'E-C 204. 15 3I'ni:0C0r>E-C 204. 15 3DMDSPGRP-BFCTR2 

BFCTR2: .FCTR L ‘04. 15 3PPThBLE -L 204. 15 3PMMDATE -CFCTP 
CFCTR; .FCTR C J04. 15 3r'PHL!t lER -n [iFCTP, EFCTR. FFCTP . GFCTP ^ 


DFCTR: 

EFCTR: 

FFCTR: 

GFCTR: 


.FCTR C204. 153CHVLACPF-L204. 153CHDSACPF 
.FCTR C204. 153CHVLGCPF-C204, 153CHPSBCPF 
.FCTR C204. 153CHVLCCPF-C204. 153CHDSCCPF 

.FCTR C204. 15 3CHVLPCPF-E204. 1 5 3I'nSTSFLG-C 204. 15 3CHPSOCRF 


0 LB:C 1. 1 3RriSl UI.DDL 
OLBiC 1 . 1 3Pri512'-:.npL 
.El ID 


1 

•> 


A 

V 

h> 


1 ; 
1 - 
12 
14 

■ i? 
i 

\i 

ir 

1C 

12 

JO 

" ' 


2 I 


30 

21 


Figure C-10. UPDCRF Overlay Description File 
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oiru 


Cr POOH QUALITY 


i OCM.ODL 
• 

; OVERLAY STRUCTURE FOR THE DBAII UPDATE COMPONENT SUMMAPY FORM 
; (UPDCSF) PROGRAM (P. LO 10/14/82; 

• 

.ROOT C204, l5DCMUPDCSF-RMSR0T-0TSR0T-AFCTP.BFCTP.0TSALL,PriSALL 
AFCTR: .FCTP C 204. 15 ]DMGETCPF-XFCTP- >-( ID I . SD2 . JDS ) 

XFCTPs .FCTP C204. 15 3DMMEI,.IPP2“C204. l5]DriDSPCHG-C204. l5iri;’L0G - -^ZTP2 

/.FCTR2: .FCTP C204.'35]CI1VhLCSF-C204. 15 ]CI1VhLDTX-C204. ISIDIIZF ILL - FCTP3 

XFCTR3: .FCTR C204. 7 3UTMhTCHS-C 204, r^UTIIOVE -C204. riUTBLrtHf - FCTP4 

XFCTR4; .FCTP C 204. 15 3DMZDATE -C204. r]UTINTG -C204. r]UFPMSIAC LB 

fDl! .FCTR C204. 153CMCHGCSF-C204. 153CMFLDCSF-C204. 153DMCACMT -SDIA 
SDIA; .FCTR r204. 15 3DMCHGCMT-C 204. 15 3DMDSPCMT-C 204, 15 3DMDELCMT-SD IB 
*D1B: .FCTR C204. 153DMADDCMT-C204. 7 3UFRMS lAC/LB 

JD2: .FCTR C 204, 15 3CMADDCSF-C 204, 15 3CMPR0CSF-C 204, 15 3CMAPCMT -5D2A 

$D2P: .FCTP C204, 153DMADDCMT-C204. 7 3UFRMS lAC/LB 

fD3: .FCTR C204, 15 3CMDELCSF-C204, l5 3DMDELCMT-!:204, 7]UFPMSIAC LB 

• 

BFC.TR: .FCTR +<rCFCTp,DFCTP,GFCTR) 

CFCTR; .FCTP C 204. 15 3CMDSPCSF-+f fD 10,$D 1 1 ) 

$D10; .FCTR C204, 15 3CMDSACSF-C 204. 15 3CMDSBCSF-C204, 153CMDSCCSF 
SD 1 1 1 . FCTR C 204, 15 3CMDSDCSF-C 204. 15 3CMDSECSF-C 204. 15 3CMDSFCSF 

DFCTR! .FCTR C204, 153DMNUMER -C 204. 15 3DMMDATE -C 204. 15 3DMC0C0DE-t£FCTR 
EFCTR : . FCTR C 204. 15 3DMSTSFLG-C 204, 15 3DMYM0RB -C 204, 15 3DMX0RB -EFCTR2 

EFCTR2! .FCTR C204, 153CMEMH0PB-C204. 153CMNUCOPB 

GFCTRs .FCTR C204, 15 3DMDNC0DE-C 204. 153DMDSPGRP-C204. 15 3DMTABLE2-GFCTR2 
GFCTR2! .FCTR C 204, 15 3DMTABLE 

• 

OLB;C 1, 13RMS11M.0DL 
OLBsC 1. 13PMS12X.0DL 

.END 



Figure C-11. UPDCSF Overlay Description File 
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ORIGINAL PAGE IS 
OF POOR QUALITY 


; 1 
; OCT.ODL 

• OVERLAY STRUCTURE FOP THE DBRM UPDRTE COMPONENT STATUS REPORT 
; lUPDCSR) PROGRAM (P. LO 10/14--82) 

.ROOT fPOOT-PMSROT-OTSROT-fOQ. OTSALL. RMSALL 
TROOT: .FCTP C 204. 15 ]CTUPDCSR-C204. 15 3CTGETCSR-C 204. 15 3DM2F ILL -4" I 

fPl; .FCTR C204, 15]DMLJUST -C 204. 15 3DMNEUPR2-C 204, 15 DDMDSPCHG-SR2 

IR2: .FCTR C 204. 152DMLOG -C 204. 15 3CTVALCSR-C 204. 15 3DMGETSEQ-SR3 

fR3s .FCTR C204. 153CTVALACT-C204, 153DMPARVAL-SR4 

tR4: .FCTR C204. 153DMSTSFLG-C204. l5]DMRrMIND-C204. 153DMNDATE -fR5 

fR5: .FCTR C204. 153CTDSPCSR-C204. 15 3CTHEDCSR-C 204. 15 3CTF0RCSR-SR6 

fR6: .FCTR C 204. 15 3DMFPNUM -C204. 153DMNUMER -C204. 15 3DMDNC0DE-$R7 

JR7: .FCTR C204, 153DMCOCODE-C204, 153DM2DATE -iRl0 

*R10: .FCTR C204. 73UTMOVE -C204. 7 3UTMATCHS-C 204. 73UTBLANK -IRll 

fRll; .FCTR C 204. 15 3CTE,YPTA8-C 204. 7 3UFRMS lAC/LB 

* . * 

fOO: .FCTR’ *<(.I>RR.SSS,*TT) 

$RR; .FCTR C 204, 15 3CTCHGCSR-C 204, 15 3CTFLDCSR-C 204, 7 3UFRMS lAC/LB 

fSS; .FCTR C 204. 15 3CTADDCSR-C 204, 15 3CTPR0CSR-C 204. 7-3UFRMSIAC/LB 

ITT: .FCTR C204. 153CTDELCSR-C204. 7 3UFRMS lAC/LB 

0 

» * 
kB'.C 1. 1 3RMS1 IM.ODL 
OLB:C 1. 13RMS12X.ODL 

.END 


Figure C-12. UPDCSR Overlay Description File 
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4 f or^* ro 10 1 3 
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OF POOK Q:^A’ !TY 


I 

; QHI.ODL 

; OVERLAY STRUCTURE FOR THE DBftM UPDATE GROWTH HISTORY FILE (UPDHIS> 

! PPOGPAN 'P. LO 10/14-'82j 

.PCOT PMSPOT-OTSPOT-fPOOT.fnO.OTSHLL.PtlSALL 
■IPOOT: .FCTP Ci05. 15 ]H lUPDH IS-C 204. 15 ]DIIGETPPO-C 204, 15 1DI1NEUPP2- EP00T2 

fP00T2: .FCTP C204. 15 3DMDSPCHG-C20^ 153DIILOG -C 204. 15 3H I7ALH IS-IP00T3 
fROOTS: .FCTR C 204. 15 ]DMPAPVAL-C 204, 15 1DI12DATE -C 204. 15 ]Dlin0VEBL--3rR00T4 
•JP00T4: .FCTP C204. 7 3UTBLAMK -C204, PDljniOVE -r204, ? DUTHATCHS-SPOOTS 
SR00T5: .FCTR C204. 7 3UFRMS I AC/LB-fPOOTb 
SR00T6: .FCTR ♦<( *BB. SCC, SDD) 

fBB: .FCTP C204. 153HICHGHIS-C204. 153HIFLDHIS-C204. 7 3UFPMS lAC/LB 

JCC: .FCTP C204. 153HIADDHIS-C204. 153HIPR0HIS-C204. 7 3UFPt1S lAC^LB 

$DD: .FCTR C204. 153HIDELHIS-C204. 7 3UFPMS lAC/LB 

■koOi .FCTR M$PP.*SS) 

■iRR: .FCTP C204, 153HIDSPHIS-C204. 153HIDATHIS-C204. 153DMLJUST -.tPR2 

SRR2: .FCTP C204. l5 3Df1STSFLG-C204. 15 3DMMDATE -C 204, 15 3DMMUYER -.«RR3 

SRR3; .FCTR C204. 73UTCHAPEO 

SSS; .FCTR C204. 153DI1DMC0DE 

• 

OLBtC 1. I 3RMS11M 
9LB;C 1. 1 3RMS12X 

• END 


Figure C-I3. UPDKIS Overlay Oeacriptlon File 
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ORIGINAL PAGE 18 
OF POOR QUALfTY 


j ORft.ODL 

! OVERLAY STRUCTURE FOR THE DBRM UPDATE RUN ANALYSIS FORM (UPDRAF) 

: PROGRAM fP. LO l0/'l8/'82) • 

• 

.ROOT fROOT-RMSROT-OTSROT-SAA. SCC. otSALL, RMSALL 
SROOT: .FCTR C204. 15 IRAUPDRAF-C 204, 15 3RAGETRAF-C204. 15 :DMNEUPP2-SR2 

fR2: .FCTR C 204, 15 DDMZF ILL -C204, 153DMDSPCHG-C204, 15]DML0G -3R3 

$R3: .FCTP C204. 15 IPAVALRAF-C 204, 15 DDMGETSEQ-C 204, 15 ]PAVALCMP-5P4 

SP4: ,FCTP C!'04. 15 3I>MPAPVAL- [ 204. 15 ir'MSr'ATE -C2A4, 1 iPAVHLDTV-'r'^G 

$R6: .FCTP C 204, 15JDMCACMT -C 204, 15 DDMCHGCMT-C 204, 15 DDMFSPCMT-fR? 

$Pr: .FCTP C204, 15-]DMADDCriT-C204, 15]IinDELCIIT-JR3 

$R3: .FCTP C204, 7]UTriOVE -C204, 7 3UTMATCHS-C 204, 7 ]IJTBLhMK -IPS 

fR9: .FCTP C 204, 7 3UFPMS lAC/LB 

$AA: .FCTP M $BB1 . fBB2, $BB3) 

SBBl: .FCTR C 204, 15 3RACHGRAF-C 204. 15 3RAFLDRAF-C 204, 7 3UFPMS lAC/LB 

$BB2: .FCTP C 204. 15 3RAADDRAF-C 204, 15 3RAPR0RAF-C 204, 7 3IJFPMS lAC/LB ■ 

$BB3j .FCTR C204, 153RADELRAF-C204. 73UFRMSIAC/LB 

• 

icC: .FCTP ■♦^(JEE.fFF.SGG) 

0 

f'EE: .FCTP C204, 15 3RADSPRAF-C 204, 15 3RAHEDRAF-C 204, 15 3RADATRAF-rEE2 

*EE2; .FCTR C 204, 15 3DMC0C0DE 

■fFF: .FCTP C 204, 15 3DMSTSFLG-1: 204. 15 3DML.TUST -C 204, 15 3DMNIJI1ER -TFF2 

*FF2: .FCTP C204, l53DilHDATE -C 204, IS 3DMX0RB -C 204, IS 3DMYH0RB 

SGG; .FCTP C 204, 15 3DMDNC0DE-C 204, 15 3DMTABLE -C 204, l’5 3DMDSPGRP 

0 

OLB;C I, I 3RMS1 IM 
0LB:C I, I 3RMS12X 

. END 


I 


•> 

4 

5 

6 
"0 

I 

O 

o 

9 

10 
» • 

12 


17 

18 

19 

20 
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24 
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Figure C-14. UPDRAP Overlay Description File 
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cn:cn>‘u. [3 

OF POOi^ QUa'^LITY 


i 


i 


i 


ORS.OPL 


OVERLkVi' structure for the DB(W update resource summary form lUPDRSFX 

PPOGPhM IP. LG 10 10 '32) 


>PDOT: 
XPnOTJ 
XP00T3 
'TROOT4 
XRDOTL) 
f ROOTS 
$R00T9 


.PGilT PM'*PGT"OTSPnT-TPOOT. rm. OTSALL. PMSALL 
.HCrP' L JH4. 15JRSUPr'PSF-C204. 1 5 JPSGETRSF-C 204 . ISITMZFILL -TR00T2 
.FCTP C2G>, lSl[iniiri-iFP2-C2G4. 1 5 IDriPSPCHG-C 204. 153DMLOG -TR00T3 
.HCTR C204. 15 JPSVHLPSF-r204. 15JDMGETSEG i‘ '04. 15 3I'riPAPVAL-rROOT4 
.FCTP C204, l5]DMP['ltIIID-[;204. 153DiiZDATE -.204. 15 IDMSTSFLG-i'ROOTS 
.FCTR C2Q4. P DUTMhTCHS-C 204. 73UTMOVE -C204. 73UTBLANK -TROOTb 
.FCTR C204. r]LIFPtTSIAC LB-SR00T9 
.FCTR tiiSAA.fBB.^CC) 


fAA: 
fBB: 
TDB2: 
•XCC : 


.FCTR C204. 153RSCHGRSF-C204. 153RSFLDRSF 

.FC7R C204. 151RSADDPSF-C204. 15 3RSPR0RSF-C 204, 15 3RSGETRES-TBB2 
.FCTR i;204. 15 3RSGETV0L-C204. r3UFPMSIAC LB 
.FCTR C204. 15]RSD(-;LPSF-C204. 7 3UFRNS I AC. 'LB 


I 


fPD; 

.FCTR 

M,XEE.'fFF) 

*EE: 

. FCTR 

C204. 15 3RSPSPRS • C204. 

■TEE2: 

.FCTR 

C204. 15 3RSCOMRSF -C204. 

■XEE3; 

.FCTP 

C204, 15 3DML.IUST -C204. 

JFF: 

.FCTR 

C204. 153PMDNC0PE-C204. 

$FF2; 

.FCTR 

C204. 153PMMUMER -C204. 

fFF3: 

.FCTR 

C204. riUTCHAPEO 

OLB:C 1, 

1 1RMS! IM 

'■'* 3 : C 1 . 

1 jPMsi: 

:x 


.ENT 


15 3RSHEDRSF-C 204. 15 3RSDATRSF- EEE2 

15 3PMM0VEBL-s:EE3 

153RSGETFR! 

15 3PMDSPGRP-C204, 15 3DmDATE -TFF2 
153DMFPNUM -fFF3 


.31 


Figure C-15. UPDRSF Overlay Description File 
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c: jja3-4cr.uii.oir .,.- j— o i ;j - 1 



ORIGINAL PAGE IS 
OF POOR QUALITY 


t 

> UPDATE SUBJECTIUE EUALUATION DIRECTORY <DZR) PILE 

» OVERLAY STRUCTURE. <J. COOK 11/4/82) 

I 

.ROOT *TREElfOTSALLfRMSALL 
liTREEl; .FCTR 4R00T-RMCR0T-0 TSROT 

» 

•root: .FCTR C204tl53SDUPDDIR-C204fl33'SDADDDIR-C204fl51SDCHODXR-*Rl 

*Ri: .FCTR C204>1S38DDELDIR 

» 

0LE<:C1>13RMS11M.0DL 


ffLEi:Cl.lJRHS12X.0DL 

.END 


Figure C-16. UPDDIR Overlay Description File 


; OMF . ODL 

; OVERLAY STRUCTURE FOR DBftfl UPDATE CIF FORTRAN MODULE FUNCTION 
; UTILITY (4-"30/82 BY P. LO) 

.ROOT PHSROT-OTSROT-fROOT.OTSALL.RMSALL 
SROOT; .FCTR C 204. 15 3MFUPMFUN-C 204, ? ]UTM0VE-fR00T2 

JR00T2: .FCTR n(SGTPRJ,$PROCF) 

fGTPRJ: .FCTR C204, 15 3MFGTPRJ i 

•iPROCF: .FCtR C 204. 15 3MFPROC IF-C 204, T 3UTBLAHK-C 2C4. 15 3DMZDATE-SPR0C 1 1 

JPROCl: .FCTP [2G4. 63R5CTYPE 1 

9LB:C I, 1 3PMS1 IM I 

0LB:C 1 . 1 ]Rf1Sl2>^ \ 

.END i 


Figure C-17. UPDKFN Overlay Description File 
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I 


or HOOK QU/iLlU 


; OSF.ODL 

• OVERLAY STRUCTURE FOR DBAM UPDATE STATUS FIELD FUNCTION 

.ROOT RMSPOT-OTSROT-$ROOT.OTSALL.RMSALL 
$ROOT: . FCTR C 204. 15 3SFUPDSFG-C 204, 7 3UTM0VE-$R00T2 

SR00T2; .FCTR >k($GPR,SVFY,JGST,$UPS) 

• 

$GPR; .FCTR C 204, 153SFGTPROJ 

$VFY: .FCTR C204. 153SFVFYF IL 

fGST; .FCTR C 204, 15 DSFGTSTAT 

• 

$UPS: .FCTR C 204. 15 3SFUPSTAT-C204. 7 3UTBLANK-C204, 153DMZDATE 

• 

OLBtC 1, 13RMS11M 
QLBrCl, 13RMS12X 

. END 

Figure C-18. UPDSFG Overlay Description File 
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APPENDIX D - INDIRECT COMMAND PILE LISTINGS 


Appendix D contains indirect file command listings. 


Figure 

D-1 

D-2 

D-3 

D-4 

D-5 

D-6 

D-7 


D-8 


Contents 


DBAM Driver 

Update Function 

Archive Function 

Create Function 

Restore Function 

Compress Function 

Update FORTRAN Module 
Function for CIF Pile 
Function 

Update Status Flag 
Function 


ORIGINAL PAGE IS 
OF POOR QUALITY 


« SaFTUARE ENOINEERXNO LABORATORY « 
» DATA BASE HANAOEHENT SV8TLH « 


DETAILED OPERATOR INSTRUCTIONS MAY DE OBTAINED BY LISTZNO 
‘SELDBS.HLP* OR BY CONSULTING THE USER'S GUIDE. 


START SEL DBAM «« 
too: .Y«3KB OPER ENTER FUNCTION TYPE 


.IF OPER O ‘ADD* .OOTO 200 
OADDALL 
.OOTO too 


.2001 .IF OPER 
0UPDATE 
.GOTO 100 

O ’UPDATE’ 

.GOTO 300 


.300S ,IF OPER 
8CREATE 
.GOTO too 

O ’CREATE’ 

.GOTO 500 


.soot .IE OPER 
SARCHIV 
.GOTO too 

<> ’ARCHIVE’ 

.GOTO 400 


.400t .IF OPER 

<> ’RESTORE’ 

.GOTO 450 



QRESTOR 
.GOTO too 

,4501 .IF OPER <> ’COMPRESS’ .GOTO 460 
QCOMPRESS 
.GOTO 100 

.4401 .IF OPER <> ’UPDMFN’ .GOTO 470 
GUPDMFN 


•GOTO too 

.4701 .IF OPER ’UPDSFO’ .OOTO 700 
OUPDSFO 
’.GOTO too 

.7001 .IF OPER <> ’STOP’ .GOTO 800 
.GOTO 700 

.soot («** INVALID FUNCTION SPECIFIED, 
f USE - 'ADD'. BATCH PROCESSING OF ADDITIONS 

» 'UPDATE'. INTERACTIVE DATA UPDATE 

> 'CREATE'. ADD NEU PROJECT 

t 'ARCHIVE'. SAVE DB ON TAPE 

» 'RESTORE'. REPLACE DB FROM TAPE 

» 'COMPRESS'. COMPRESP .PECIFIED DATA BASE FILE 

t 'UPDMFN'. UPDATE FUA1RAN MODULE FUNCTION FOR 

i 'UPDSFO'. UPDATE STATUS FLAG PIELDS UITH ONE COMMAND 

J 'STOP'. TERMINATE PROURAM 

. i END WHILE 
.GOTO too 


900 S l««i 


END SEL DBAN 


Figure D-1. DBAli Driver Indirect Command File 


nvi 


ORIGINAL PAGE IS 
OF POOR QUALITY 


I «•«««•««•«««••»»»« UPDATC FUNCTION •»«••««»»»»«««*««* 
.loot .AtKS FORN CNTCR FORN TYFC 
I 

.IF FORN O *RAF* .GOTO 200 

OUFDRAF 

.GOTO 900 

.200t .IF FORN <> *R8F* .GOTO 300 

0UPDR6F 

•GOTO 900 

.300t .IF FORN <> *CSR* .GOTO 400 

OUFDCSR 

•GOTO 900 

.400t .IF FORN <> *CSF* .GOTO SOO 

GUPDCSF 

.GOTO 900 

.5001 .IF FORN <> *CRF* .GOTO 400 

GUPDCRF 

.GOTO VOO 

.400t .IF FJ3RN <> 'CIF* .GOTO 700 

8UP0CIF 

.GOTO 900 

.7001 .IF FORN <> ‘HIS* .OOTO 720 

0UPDHI8 

.GOTO 900 

.7208 .IF FORN <> ‘STS* .GOTO 730 

9UPDSTS 

.GOTO VOC 

.730t .IF FORN <> 'ENC* .GOTO 740 

GUPDENC 

.GOTO 900 

.7408 .IF FORN <> 'EGT* .GOTO 750 

OUPOEST 

.GOTO- 900 

.7508 .IF FORN <> 'GEF* .GOTO 740 

GUFOSEF 

.GOTO 900 

.7601 .IF FORN <> *HDR* .GOTO 000 

OUPOHDR 

.GOTO 900 

.8008 .IF FORN <> *DIR* .GOTO 850 

OUPODIR 

.GOTO 900 

.8508 .IF FORN - •STOP* .GOTO 900 
l«t* INVALID FORN TYPE SPECIFIED. 

.GOTO 100 

.9008 (««««*»*«««•«««*« RESTART 8EL DRN3 «««»«««««•*»««: 


Figure D-2. Update Function Indirect Command File 
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original page is 

OF POOR QUALITY 


SET TEF^.IICP 
.ENABLE SUBSTITUTION 
QC2G4.4nCHEC UPDhFCHIV STAPT 

.ASKS LABEL C MOUNT TAPE ON MMO ] ENTER TAPE- ID (TO 6 LETTERS) 

ALL MMO : 

.IF <EXSTAT> EO 1 *: INI MMO; 'LABEL' -'DENS -1600 

.IF <EKSTAT> EQ 1 MOU MMO: 'LABEL' /DENS-1600 

.IF <EXSTAT> EO 1 RUNNING D.B. ACTIVITY REPORT (READING TRANSACTION 

.IF <EXSTAT> EQ 1 RUN C 204.5 :RC/TASK-RC 

.IF <EXSTAT' EQ 1 ; PLEASE PRINT RECENT. RPT AND DELIVER COPY TO JERRY 

.IF <EXSTAT: EQ 1 RUN C204.5JDMARCFIL 

.IF <E;-(STAT) EO 1 BCK QFILNAM.DAT 

,IF <E,XSTAT,' EQ 1 BCK MMO : TRANS . DAT-DBO : C 204. 1 DTRANS . ;«/SL : ARCH 1V2 . LS 

@C204.4:CHEC ARCH IV END 
PR I ARCHIV.LST 
DM0 MMO: 

DEALLOCATE MMO: 


1 

1 

I 

1 

1 

1 

1 

i;* 


Figure D-3. Archive Function Indirect Command File 
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r • r*-i -* iri .xi i\- oo cti o oj I'l -j u-i 



.ENABLE SUBSTITUTION 
.ENABLE GLOBAL 
.ENABLE QUIET 


J' i 


^ 13 

ry 


.SETS «NAME PI 

.SETS «VTYP •CIFCNTCRPCSFCSRHISRAKRSF* 

.SETN *NTYP B. 

.SETS tUICl ■C204»U* f MATA BASE FILLS 

.SETS *UIC2 *C204»43* » DEFINE OOMHAND FILL UIC 

•SETF tPROMT 

.IF 4NAME EQ '• .SETT *PROMT 

.IFT 4PROHT M $$$$*$$* CREATE FILES FOR NEU PROJECT «««»«««» 

.SETF TERROR 
.SETF «EOF 
.SFrN TALLOC S. 

.SETN «EXTEN 8. 

.SETN •DFILL 512. 

.SETN 4IFILL 950. 

.SETN 4FILLA 1000. 

,SETN *FILLB 1000. 

.SETN ♦FIILC 1000. 

.SETN tFILLD 1000, 


.UHILEi; .$ MORE PROJECTS 10 CREATE 

.IFT FPROMT .ASKS tNAML ENTER NEW PROJLCI NAME UR •SlUC* 

.IF 4NAME EO *SrOP* .0010 ELSE! 

.OPEN *1 [:204,.nPRUNAM.DAI 
.DATA #1 '*NAME' 

.CLOSE *1 

M UPDATING ENCODING DICTIONARY AND FILE STATUS FILE 
RUN L204fS3DMCREFIL 
.SETF TERROR 

.TASK FERROR ARE THERE ANY ERRORS SO FAR 
.IFT iERROR .GOTO ENDIF2 
.SETN ITYP 1. 

.WH1LE2: ,( ITYP LE 24 (3 * $NTYP> 

.SETS »TYP ♦VTYPCITYP:ITYP+2, 3 
.SETS •DBF2 *UIC1+*NAHE+’ . ‘F^TYP 
.TESTFILE '*DBF2' 

.IF <FILERR> EO 1 .GOTO ELSE4 

• CREATING '♦DBF2' 

6' 4UIC2' DEFINE '4FYP' .CMD 
.GOTO ENDIF4 
.ELSE4T 

.SETT $ERROR 

M FILE '»DBF2' ALREADY EXI8TSI NEU FILE NOT CREATED 
.ENDIF4: 

.SETN ITYP ITYP+3. 

.FEND WHILE MORE FILES TO CREATE FOR CURRENT PROJECT 
.IF ITYP LE 24. .GOTO WH1LE2 

.EN0IF2: 

.GOTO ENDIFl 

.ELBEi: .» 'STOP* ENTERED 
.SETT $EOF 
.ENDIFi: 

.»END WHILE NOT EOF 

.IFT »PROMr .AND .IFF «EOF .AND .IFF 4ERR0R .GOTO UHILEI 


.IFF iERROR SRD 99».TMP/DE 
! I 

• I END OF CREATE 
) ! 

.stop; 


Figure D-4, create Function Indirect Command File 
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SET TERM/MCR 

BEGIN RESTORE ««««;» it 

♦ 

} PLEASE READY YOUR TAPE FROM THE SYSTEM CONSOLE 
i 

r HOU MM0:XXXXXX/DEN8«1400 
t 

! WHERE •XXXXXX* IS THE TAPE IDENTIFICATION 

V 

.ENABLE SUBSTITUTION 
(3C20‘1j^>:CHEC RESTOR START 

♦ OPEN l-ILNAM.DAT 

♦lOO; .ASKS FNAHE ENTER FILES (LIST/ALL) 

.IF FNAME <> 'ALL* .GOTO 200 

♦ DATA :k.«*MMO: C20AyI38EL0BS.DAT 
.CLOSE 

RST GFILNAM.DAT 
JR'JN C20Ar1.-13DMRESFIL 
RUN C204fS3DMRESFlL 
.GOTO 700 

.200: .IF FNAME • •• .GOTO 900 

.IF FNAME O 'LIST* .GOTO 100 

. f DATA C204 » 1 3;K . *»MMO : C204 1 1 3SELDBS . DAT/SE { - 

.DATA * . JK^MMO J C204 » 1 iSELDDS . DAT/SE i - 

.300; .ASKS FNAME ENTER FILE NAME TO SAUE 

.IF FNAME * •• ..GOTO 700 

.DATA 'FNAME' 

.GOTO 300 

».700: .DATA C204f3DN0TFlL.DAT 

.700: .DATA 

.CLOSE 

RST SF1LNAM.DAT 

.900: END RESTORE 

QC204f43CHEC RESTOR END 


Figure D-5. Restore Function Indirect Corrimand File 
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. . ?3 

Oi rOujt Q»;AuiTY 


THIS INDIRECT FILE (PROGRflri) COMPRESSES THE SEL ORTR BASE 

DAVE UYCKOFF JUL 01 

baseline 


CPR 


HELP 

CMP 

FILDIR 

CMPFIL 

DEFNEU 


10 

20 

30 

40 

SO 

60 


.ENABLE SUBSTITUTION 
.enable GL'BAL 
.ENhBLE CiUlET 


(3C204. 

.SETS 

.SETS 

.SETS 

.SETS 

.SETS 

.SETM 

.SET? 

.SETN 

. i-tllH 

.SETF 


41CHEC 
*P1 PI 
tP2 P2 
*VTVP 
fiJiCl 
fUlC2 
INFILE 
L "L“ 

IE ;tp 1 
IE .TP 2 
lEPPOP 


COMPRESS START 


"ACChTHCIFCMTCRFCSFCSREHCESTGPSHDRHISRAFRSFSEFSTS* 
"C204.1]" : FOR NOU THENC204.1] 

■'C204.4]" ! FOR NOU THEN [204.33^ 

1. 

n. 

10 . 


.PhFSE ijic "C.3" Dumv GROUP MEMBER DUMPfi’ 

.IF GROUP tO "204" .GOTO ENDFIO 

'1 UIC ■ UIC''* CANNOT COMPRESS THE DATA BASE. 
.STOP 
.ENDF 10! 


YOU MUST USE A 204 UIC. 


.SETF IPROMT 
.IF IPl EO "" 
. IFT IPROMT 
. IFT IPROMT 


.SETT IPROMT 

!! DATA BASE COMPRESS UTILITY. ENTER HELP FOR HELP. 

'! A BACKUP TAPE SHOULD BE RUN BEFORE THIS COMPRESS. 
.OPEMh #1 MSG. DAT 
.SETS DA "[204. J3CPP.PR0" 

.TESTFILE 'DA' 

.PARSE vFlLSPO "j" DUMMY VERS 
.ENABLE DATA *l 

DATA -BASE COMPRESS VERSION 'VERS' '<DATE>* '<TIME>* 

ACT *REC BLK FILLS 
.DISABLE DATA •! 

.UHIL12: .! MORE USER COMMANDS AND NO PARAMETERS ON COMMAND LINE 
.IFT IPROMT .ASKS IPl COMPRESS> 

.IF IPl NE "HELP" .AND .IF IPl NE “H" .GOTO ELSE14 
.GOSUB HELP 
.GOTO ENDF 14 
.ELSE 14; 

.GOSUB CMP 
.ENDFU: 

.jEND UHILE 

.IFT IPROMT .GOTO UHIL12 
.CLOSE *1 

I I 

,'i END OF COMPRESS. 

!l .A SUMMARY OF RESULTS IS CONTAINED IN MSG. DAT. 

I I 

.SOTO STOP 


.HELP: .: THIS SUBROUTINE WRITES HELP INFORMATION TO THE TERMINAL. 

! ! 

II IF vrij WANT TO COMPRESS A SINGLE FILE. ENTER THAT NAME. 

' ' WILDCARDS IK) MAY BE USED TO SPECIFY ALL PROJECTS OR ALL 
i! t-QRM TYPES. FUR EXArPLE: 


Figure D-6. 


Compress Function Indirect Command File 
(1 of 6) 
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ORIGINAL PAGE IS 
OF POOR QUALITY 


I I 

i i 

I 1 

i i 
! ) 
I I 
I i 


C0IPPE'=.S)CS3 
♦ C0MPPE«'£ CS3 
K COtfPESS C53 
C0I1PPESS'>CS3 


DEA.PAF 
f .PAP 
I'Eh. r, 

■M, •* 


THESE mV BE ENTERED ON THE COrtlAHD LIME. 
QC204,n3C0riPPESS ♦‘.PhF 


FOR EXAMPLE; 


.PETUPN 


.lMP: 


THIS SUBROUTINE READS THE DIRECTORY FILE OF SELECTED DB FILES AND 
■OnPPESSES EACH OF THEM. 

: CREATE A DIRECTORY FILE CONTAINING NAMES OF FILES TO BE COMPRESSED 

G05UB FILDIP 

I FT JEPPGF .GOTO EMDF30 
.OPENP *2 SSDIP.TMP 

. ! DUMMY READ TO GET PAST THE HEADER 
•READ *2 DUMMY 

.IFTEOF> .GOTO ELSE32 

.! PIP DIP HEADER • 'DUM1Y' 

.SETF SEOF 

.UHIL34; MOPE FILES TO COMPRESS 
.READ *2 RECORD 
.SETS P PEC0PDC5. : 12.3 

.IF P EO "TOTAL OF" .OP . JFT .'EOF'' .GOTO ELSE36 ; (SAY EOF) 
'CMP PEC FPOM PIP FILE IS ‘PECC'^D' 

.SETS PEC PEC0RDC3. :25. 3 
.PARSE PEC " " fllAME DUMMY 
.PARSE *MAItE fPROJ ST'.? fVEFSl 

.SETS fDBFI "C204. 1 3"+«NAME 
.SETS SDBF2 *UICl+*PROJ+". "+$TYP 
.: JNAME • 'SNAME' 


I ( 


COMPRESSING FILE **DBF2' 


READ #2 REC2 
; REC2 • 'REC2' 

PARSE REC2 SALC DUMMY 

SETS *CHR SALC 
GOSUB CHRINT 
SETH SALNOU SNUM 

: SALC - 'SALC* SALNOW • 'SALNOU' 

SETF LOCKED 

SETS TT REC2C 10.: 10.3 

; RECO0) • 'TT' 

IF L EQ REC2C 10. : 10. 3 .SETT LOCKED 
IFT LOCKED .GOTO ELSE38 

.SETS CHAR REC2C9.:9.3 

IF COMPRESSING NON-CONTIGUOUS FILES ONLY AND NON-CONTIG. 
.IF CHAR EQ "C" .AND .IF SP2 EQ "NOCONTIG" .GOTO ELSE37 
.GOSUB CMPFIL 
.GOTO ENDF37 
.ELSE37: 

II FILE 'SDBF2' IS ALREADY CONTIGUOUS: IGNORED 
.ENDF37; 


FILE 'SNAME' IS LOCKED. NOT COMPRESSED 


.GOTO EHDF38 

.ELSE30: .: FILE IS LOCKED 

II FILE 'SNAME' IS LOCKED (AND THEREFORE IGNORED) 
.DATA #t '<TIME>' “ ' 

.EMDF38: 

.GOTO ENDF36: 

.ELSE36: 

.SETT SEOF 
.ENDF36: 

* .IFF SEOF .GOTO UHIL34 
.GOTO ENDF32 

.ELSE32: .; ZERO FILES SELECTED 
II NO FILES SELECTED 

.DATA *1 '^TIME>' NO FILES SELECTED 

.ENDF32: 

.CLOSE «2 
SRD 99*.TMP/DE 
.ENDF30: 

.RETURN 


Figure D-6. 


Compress Function Inciirect Command File 
(2 of 6) 


D-8 



fooR 


.PILDIPi J^*fortpSE?SEr«^^^ CREATES OF PIP DIRECTORY OF SELECTED DB FILES TO 

'»P1* 


.GOTO ELSE40 
*PPOJ fTt'P 

.GOTO ELSE42 


.SETF »EPPOR 
.! ■FlLDiP> tPl 
. IF fPl EO ““ 

.PARSE »P1 
.TEST fPPOJ 
. IF STPLEN. GT 9. 

.TEST tT'i'P 

.IF ‘STPLEN^ LT 1. .OP .IF <'STRLEN> GT 3. 
.; *PR0J ■ **PFOJ' *r,'P . ‘sr,?' 
PIP 99DIR.TMP • C 204, n*»Pr 'Ll 
.GOTO EMDF44 
.ELS|44; 

.SETT lEFPOP 

' I IM'^ALID STPIMG 'fPr 
.ErtDF44: 

.GOTO EMDF42 
.ELSE42: 

.SETT *EPROP 

INVALID STRING •*?!' 

.ENDF42! 

.GOTO ENDF40 

.ELSE40! NULL LIME ENTERED,* IGNORE IT 
.SETT tEPPOP 
.EMDF40: 

. PETUPN 


.GOTO ELSE44 


.CMPFIL: .. THIb SUBROUTINE DOES THE COMPRESS ON THE SINGLE GIVEN FILE. 


.TEST *VERS1 
.SETF JACTIV 
.'IF 'STRLEN> LE 2 
.TESTFILE **DBFl' 

. IF -FILERP> HE I 
.SETS $TY *TVP 
.IF *TVP NE "HDR" 

■ SETS $T,‘ “X" 

.IF fPROJ EQ "ENCODE" 

.IF fPROJ EQ "EST" 

.IF SPPOJ EQ "HEADER" 

.IF SPPOJ EQ "SEF" 

.IF *PROJ EQ "STAT" 

.IF $TY EO "X" I 

.ENDF5G: 

.SETS DEFDSN «JIC2■^“DEFINE“■^*TY+".CMD 
.TESTFILE 'DEFDSN* 

.IF <FILERR> NE 1 .GOTO ELSES2 

CREATE NEU FILE 


.SETT $ACTIV 

.GOTO ELSE50 { (FILE NOT FOUND) 
.GOTO ENDF56 


.SETS »TY "ENC" 

.SETS *TY "EST" 

.SETS 'tTY "HDP" 

.SETS STY “SEF" 

.SETS *TY "STS" 
INVALID FILE NAME GlVENi 


'•NAME* 


.GgS^^DEFNEU. 


_ _ ^0 "DSP" DSP 'SDBF2'/FU 

.IFTSERROR .goto ENDF54 

£9?'^ JLD^, VERSION TO NEU.^RSION (EFFECTIVELY COrPRESSING IT) 

.IF *P2 NE "NOCNV" FL 'SDBF2'/^0 • '*DBF1'/N0S0 
II BEFORE AND AFTER FILES; 

SRD 'SDBF2' 

.SETS FLAG "I* 

.IFT SACTIV SETS FLAG "A" 

- IfiATA #1 '<TIME>' 'FLAG' 'SNFILE* 'SNREC* 'SALLOC' **DFILL' 'SIFILL" 
.ENDF54; 

.GOTO ENDF52 

.ELSE52: .; DEFINE COMMAND FILE NOT FOUND 

!! FILE DEFINITION COMMAND FILE 'DEFDSN' NOT FOUND 


* .DATA *1 '<TIME>' 
.ENDFB2; 

. GQTO.ENDF50 

.ELSE50: .: NO DhTA BASE FILE 
II FILE 'SDBFl' NOT FOUND 
.DATA ♦! '<T1ME>' 

.ENDF50; 

.M SNFILE 
.RETURN 


FILE DEFINITION COrtlAND FILE 'DEFDSN' NOT FOUND 


(SHOULD NEVER HAPPEN) 
(SOMETHING URONG) 
FILE 'SDBFl' NOT FOUND 


Figure D-6. 


Compress Function Inciirect Commanci File 
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original Pf>®* “ 
OF POOR QUALITY 


lE< j; 


•.VL.* livTI.iE M'PIhE- H I.E.J ?Ii-E r.:-P GIVCfl FILE T.'PE. 


fTVP • ’fTVP- fnrTIV - ’fMCTIV* 

fuic: - ’furc?' 


.j ■lLPnr!:!' i'le's * 

f . * JriLiiuiJ* 

.'-FTP fEPPDP 
, jLTF FuuhIi . 

.■^ET'i fl-B lFP0-' + ". '‘+fT'/P 

Pull .-Ti .(-CPTPhN. PPij.jPHil TO GET CUPPEMT NUUBEP OP kECOPDS IM ?9PEC.Trr 
. OP El I #0 9'5PPJ.TltP 
.limTh *0 ’il'B’ 

.CLOSE *0 
:‘'.'ii [00 JST 
. . rEni-- #0 jOFE. 

.PEhD *»T PECC'PE' 

. .lO'. P 1*0 

COIIV'EPT CHhFhC’PP TO IllPEGEP 
, ;ET'i ICHP PPrOFDC 1 . iS. ] 

.GuSUB i.HPIHT 
. =-ETtl ftIPEC 'fMUn 
.SE^II fPECL *•'. 

.SETH fill E , 0. 

-HP PECCPp PPGI! 99PEC.ltlF - ■PECOPP' IHPEC ■ ’»NREC* 

It- flit-EC EG 0 .iiUTO ELI 


. :r r,T p 

, 

. : P T; I 
. SETH 
. EiiPFE i : 

. IF SPiP 
.SETT 
.SETH 
. SETH 
. EllPFE i ! 

. IF i.T,P 
. SE'^’T 
.SETli 
.PETtl 
.EMPF64: 

. IP $T,P 
.SETT 
. SETH 
.SETH 
.EMPFbSi 

. IF *TYP 
.SETT 
.SETM 
.SETH 
.EHDFbEi 

. IF $TVP 
.SETT 
.SETH 
.SETH 
. EHDFbP ! 


HE "h'T" 
i-GuliP 
fFEt'i, sr 
fill- C'/ 1 . 


HE "CIF" 
FOUHP 
fPECL 30. 
flllEr' 3. 


HE “CUT" 
FOUHP 
JPELl 1u4. 
ihl E l' 1 . 


HE "CFF" 
FOUND 
$PECL 101. 
fHKEV 1. 


HE "CSF" 
FOUHP 
JKECL 250. 
JHKE'i' 2. 


HE "CSP" 
FOUND 
JPECl 79. 
fHKE'r' 3. 


. IF *TVP 
.SETT 
.SETH 

. 'l< U III 

.EMDF72 


HE "HIS" 
FOUND 
fPECL 29. 
SHlii I. 


.GOTO EMDF.bl 


.GOTO ENDF63 


.GOTO EHDF64 


.GOTO EHDFbS 


.GOTO EHDFee 


.GOTO EHDF67 


.GOTO EHDF72 


Figure D-6. Compress Function Indirect Command File 
(4 of 6) 
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.GOTO EHDfT3 


.GOTO ENnF?4 


.SETT FOUND 


■^^^r^TIV •‘=°W!5 sE 99 

• ill kt 


.EUS 


TM gx'fpN 


nSRKL*7.)) 

MR*(SRECL+7. ). (SDFILL/??. )4*E>aRl 
JflLL/ 

3? 


NR *NkEC/|».*l. 

;]R*(SRECL+7.) 
t*ALL '1O.+1.)*I0. 


.,TN .. 
SgTN $F 
TO EN 


J50. 
950. 
. 950, 

D ■’SO. 


!?»< fji ^Rlc/lfl. + l 


TN «VLL NR*(SRECLfr.)/40.4.( 
TN MLLOC (SALL/|8.»1.)*I0. 

[Ill 1^- 


(<NK£y-l>««CXTR2) 


.ENDF99! 
R'CiFDSH' 

FlU '*1 


.pSrIe DUWT SVERS2 

.1 *VER|| » TvERSI' «VERS2 • 'tVERS2* 

.IE tVERS2 r,i. RVERSI .GOTO ENDF9E 
ccff tfPROR 

1 1 NO NEU EILE CREATED: FILE *tDBF2‘ NOT COTIPRESSED 

.DATA •! *<T|ME.'* '•NFILE' 'SHREC' **ALLOC^ *»D»ILL* *«IFIU* *»DiF2* DCF 

.ENDF9F: 
lOTO ENDF90 


FROC. NOT DONE 


•'‘•tint 

.GOTO CFi 


.E^1|^.^||^S| NO RECORDS READ ON FILE STS FILE 

--•»“^5bp,. f 

^^T|}|>' 

.EFIi 
.RETURN 


ii FlLl 'SDBFi: HAS A REC.C0yHT»9 ON THE FILE STATUS FILE. 
I SO 


UAS NOT COMPPESSE^. 

‘InFILE* ‘SDBFI* record count IS Oj NOT C0Tf>RES6ED 


.CHRINTt .: THIS SUBROUTINE CONVERTS A CHARACTER STRING TO A DECimL INTEGER. 
Bhs-vn SUBSTITUTION 



Figure D-6. 
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099INT.TMP 

.RETURN 


SCHR - **CHR' 


.STOP: 

9f 204^4 3CHEC COMPRESS END 


Figure D-6. Compress Function Indirect Command File 
(6 of 6) 
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? 

‘A 


\ 


f 

; OUPDMFN.CliD 

• 

• UPDATE THE FORTRAN MODULE FUNCTION OF A COMPONENT INFORMATION FILE 

: iP. LO 5- 18/32) 

6c204,4]CHEC updmfn start 
RUN C 204, 5 JDMIJPDMFN/TASK -UPDMFN 
0C204,4]CHEC UPDMFN END 


\ 

Figure D-7. Update FORTRAN Module Function for GIF File 
Function Indirect Command File 


; 0UPDSFG.CMD 

\ UPDATE STATUS FLAG OF A SEL DATA BASE FILE (P. LO 4/23/82) 

0C204,4]CHEC UPDSFG START 
RUN C 204, 5 31'MUPDSFG/TASK -UPDSFG 
QC204,43CHEC UPDSFG END 


Figure D~8 . Update Status Flag Function Indirect 
Command File 
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APPENDIX E - PILE DEFINITIONS 


Appendix E contains listings of the file definitions. 


Figure 


Contents 


E-1 

E-2 

E>3 

E-4 

E-5 

E-6 

E-7 

E-8 

E-9 

E-10 

E-11 

E-12 

E-13 

E-14 

E-15 


Accounting Information (ACC’ Pile Definition 

Component Information Pile (CIP) Definition 

Comments (CMT) Pile Definition 

Change Report Porm (CRP) Pile Definition 

Component Summary Porm (CSP) Pile Definition^ 

Component Status Report (CSR) Pile Definition 

Encoding Dictionary (ENC) Pile Definition 

Estimated Statistics (EST) File Definition 

Phase Dates (HDR) File Definition 

Growth History (HIS) File Definition 

Run Analysis Porm (RAF) File Definition 

Resource Summary Form (RSP) File Definition 

Pile Name and Status (STS) File Definition 

Subjective Evaluations (SEP) File Definition 

Subjective Evaluations Directory (DIR) Pile 
Definition 


E-1 



ORIGINAL PAGE 18 
OF POOR QUALITY 


■NA1 

:Nl‘ 


ILE SUBSTITUTION 

L£ Slobal 


CREATE DEFINE COMMAND FILE UITH APPROPRIATE PARAMETERS 
.6pEN #3 99DEF.TMP 
.ENABLE DATA *3 
; ;; DCU 6/29^81 

; t: THE FIRST QUESTION ASKS FOR THE FILE SPECIFICATION. 

'SDBF2' 


NO 


» 

M THE NEXT QUESTIONS DEAL UITH 

IDX 

FILE ORGANIZATION 

FIX 

RECORD FORMAT 

67 

;; RECORD SIZE 

VES 

CARRIAGE RETURN CONTROL 

• 

;; THE FOLLOUING QUESTIONS DEAL 

STR 

;j DATATYPE (PRIMARY KEY) 

• 

IS KEY LOCATION 

£ 

* 0 

;j KEY LENGTH 

o 

• 

s: KEY NAME, (IF ANY) 


8. RECORD ATTR 


NO 


DUPE keys: 



NO 


MORE KEYS? 



• 


THE NEXT OUESTIONS DEAL UITH ALLOCATION 

'/ES 


DEFINE AREAS? 



NO 


PLACEMENT CONTROL? 

(AREA 

#1) 

'iALLDC' 


INITIAL ALLOCATION 

(BLOCKS) 


2 


BUCKET SIZE 



'SEXTEN' 


DEF EXTENSION 



YES 


CONTIGUOUS AREAS? 



YES 


MORE AREAS^ • 



NO 


PLACEMENT CONTROL? 

(AREA 

#2) 

10 


INITIAL ALLOCATION 



2 


BUCKET SIZE 



10 


DEF EXTENSION 



YES 


CONTIGUOUS AREAS? 



YES 


MORE AREAS? 



NO 


PLACEMENT CONTROL? 

(AREA 

#3) 

10 


INITIAL ALLOCATION 



2 


BUCKET SIZE 



10 


DEF EXTENSION 



YES 


CONTIGUOUS AREAS? 



NO 


MORE AREAS? 




'$DFILL' 

'SIFILL' 

2 

^UED 

ftUED 
R 

.DISABLE DATA 
.CLOSE #3 

.; DEFINE NEU INDEXED FILE 
DEF 899DEF.TMP 

.RETURN 


THE NEXT QUESTIONS DEAL UITH ASSOC KEYS TO AREAS + FILL SIZES 
DATA BUCKET AREA # FOR THIS KEY (PRIMARY AND ONLY KEY) 
FILL NUMBER FOR DATA BUCKETS 
INDEX BUCKET AREA * 

FILL NUMBER FOR INDEX BUCKETS 
LOU INDEX 

THE FOLLOUING QUESTIONS DEAL UITH FILE PROTECTION 
GUNER 

GROUP 

SYSTEM 

UORLD 


Figure E-1. Accounting Information (ACC) File Definition 


E-2 


OnfGfNAL PAGE FST 
OF POOR QUALITY 


.ENABLE SUBSTITUTION 
.ENABLE GLOBAL 

.; CREATE DEFINE COMMAND FILE WITH APPROPRIATE PARAMETERS 
.OPEN *3 99DEF.TMP 
.ENABLE DATA #3 
j i; DCU 6/29/81 

;; THE FIRST QUESTION ASKS FOR THE FILE SPECIFICATION. 


•SDBF2' 

NO 


IDX 

FIX 

YES 

§TR 


80 


NO 

YES 

STR 


‘t'ES 

YES 

NO 

YES 

STR 


10 


■£S 

YES 

NO 

NO 

NO 

NO. 

'SALLOC' 

2 

'SEXTEN' 

YES 


« M 

» » 
« • 
0 0 


0 0 
• • 
0 0 


T^^EpNEXT^QUESTlONS^DEAL WITH FILE ORGANIZATION t RECORi; ATTR 

RECORD FORMAT 
pprripn CT?p 

CARRIAGE RETURN CONTROL 
THE FOLLOUING QUESTIONS DEAL WITH KEYS 
DATA TYPE (PRIMARY KEY) 

KEY LOCATION 

KEY LENGTH 

KEY NAME (IF ANY) 

DUPE KEYS? 

MOPE KEYS? 

DATA TYPE (SECONDAY KEY) (FIRST ALT) 

KEY LOCATION 

KEY LENGTH 

KE'i' NAME 1 IF ANY' 

DUPE KEYS? 

ALLOU KEYS TO CHANGE 
DEFINE NULL KEY VALUE 
MORE KEYS? 

DATA TYPE (TERTIARY KEY) 

KEY LOCATION 

KEY LENGTH 

KEY NAME (IF ANY) 

DUPE KEYS? 

ALLOU KEYS TO CHANGE 
DEFINE NULL KEY VALUE 
MORE KEYS? 

THE NEXT QUESTIONS DEAL UITH ALLOCATION AND PLACEMENT ATTRIBUTES 
DEFINE AREAS? 

PLACEMENT CONTROL? (AREA #5) 

INITIAL ALLOCATION 
BUCKET SIZE 
DEF EXTENSION 
CONTIGUOUS 


'SDFILL' 

• • 
0 0 

FILL 

**IFILL* 

t • 
0 0 

FILL 

•SFILLA' 

0 • 
0 0 

FILL 

'SFILLB' 

• • 
0 0 

FILL 

'$FILLC' 

• • 
0 0 

FILL 

/SFILLD' 

• • 

0 0 

FILL 

0 

• ■ 
0 m 

THE FOLLOU 

• 

• • 
0 0 

OUNER 

RUED 

• * 
0 

0 0 

GROUP 

RUED 

0 

0 0 

SYSTEM 

RUED 

k 

.DISABLE 

0 0 

UORLD - 

DATA 



+ FILL SIZES 


(ALT KEY I) 
(ALT KEY 2) 


.CLOSE *3 

DEFINE NEU INDEXED FILE 
DiF 899DEF.TMP 

.RETURN 


Figure E-2. Component Information File (GIF) Definition 


E-3 



ORIGINAL PAGE 18 
OF POOR QUALITY 


.ENABLE 

.ENABLE 


SUBSTITUTION 

sLOBAL 


.j CREATE DEFINE COMMAND FILE WITH APPROPRIATE PARAMETERS 
.OPEN *3 99DEF.TMP 
.ENABLE DATA #3 
; ;; DCU 6/29^31 

: sj THE FIRST QUESTION ASKS FOR THE FILE SPECIFICATION. 

SDEFi 


NO 



• 

!J THE NEXT QUESTIONS DEAL UITH 

FILE 

IDX 

s: FILE ORGANIZATION 


FIX 

;; RECORD FORMAT 


104 

RECORD SIZE 


YES 

;; CARRIAGE RETURN CONTROL 



;; THE FOLLOUING QUESTIONS DEAL 

UITH 

STR 

;; DATATYPE (PRIMARY KEY) 



0 

10 


NO 

NO 

YES 

NO 

'*ALLOC* 

'*EXTEN‘ 


0 

'SDFILL* 

1 

'SIFILL' 

2 


^UED 
^UED 
^UED 
6 


KEY LOCATION 

KEY LENGTH 

KEY NAME, ( IF ANY) 

DUPE KEYS? 

MORE KEYS^ 

THE NEXT QUESTIONS DEAL WITH ALLOCATION AND PLACEMENT ATTRIBUTES 
DEFINE AREAS? 

(AREA #1) 

(BLOCKS) 


PLACEMENT CONTROL? 
INITIAL ALLOCATION 
BUCKET SIZE 
DEF EXTEHSIOi^ 


YES 


; CONTIGUOUS AREAS? 

YES 


; MORE AREAS? 

NO 

10 

; PLACEMENT CONTROL? 

; INITIAL ALLOCATION 


2 

; BUCKET SIZE 


10 

; DEF EXTENSION 

YES 


j CONTIGUOUS AREAS? 

YES 


; MORE AREAS? 

N0 

10 

; PLACErCNT CONTROL? 

; INITIAL ALLOCATION 


2 

; BUCKET SIZE 


10 

; DEF EXTENSION 

YES 


; CONTIGUOUS AREAS? 

NO 


; MORE AREAS? 


(AREA #2) 


(AREA #3) 


THE NEXT QUESTIONS DEAL UITH ASSOC KEYS TO AREAS + FILL SIZES 
DATA BUCKET AREA # FOR THIS KEY (PRirWRY AND ONLY KEY) 
FILL NUMBER FOR DATA BUCKETS 
INDEX BUCKET AREA « 

FILL NUMBER FOR INDEX BUCKETS 
LOU INDEX 

THE FOLLOUING QUESTIONS DEAL UITH FILE PROTECTION 
OUNER 

GROUP 

SYSTEM 

UORLD 


.DISABLE DATA 
.CLOSE #3 

.: DEFINE NEU INDEXED FILE 
DEF ®99DEF.TMP 


.RETURN 


Figure E-3. Comments (CMT) File Definition 


E-4 


UK!'JJI4AL PAGfe’ 

OF POOR QUALITY 


.ENABLE SUBSTITUTION 
.ENABLE GLOBAL 

.: CREATE DEFINE COMf^ND FILE UITH APPROPRIATE PARAMETERS 
.OPEN *3 99DEF.TrF 
.ENABLE DATA #3 
: ; j DCU b 29 81 

Ji THE FIRST QUESTION ASKS FOR THE FILE SPECIFICATION. 


*$DBF2' 

NO 


IDX 

FIN 

YES' 

I TP 


tOl 

0 
b 


tiO 

MO 

'Ves 


0 

'*DFILL* 

**IFILL' 

2 


PUED 


RUED 

^UED 


.DISABLE DATA 
.CLOSE *3 


THE NEXT QUESTIONS DEAL UITH FILE ORGANIZATION S. RECORD ATTR 
FILE ORGANIZATION 
RECORD FORMAT 
RECORD SIZE 

CARRIAGE RETURN CONTROL 
THE FOLLOUING QUESTIONS DEAL UiTH KEYS 
DATA TYPE (PRIMARY KEY) 

KEY LOCATION 

KEY LENGTH 

KEY NAr€ (IF ANY) 

DUPE KEYS? 

MOPE KEYS? 

THE NE:;T QUESTIONS DEAL UITH ALLOCATION AND PLACEMENT ATTRIBUTES 
DEFINE AREAS? 


NO 

. 

; PLACEMENT CONTROL? 

(AREA 

#n 

• HALLOO' 

! INITIAL ALLOCATION 

I.BLOCKS) 



2 ! 

BUCKET SIZE 



'JEXTEN' 

: DEF EXTENSION 



YES 

• 

i CONTIGUOUS AREAS? 



YES 

» 

j MORE AREAS? 



NO 

10 : 

j PLACEMENT CONTROL? 

: INITIAL ALLOCATION 

(AREA 

*2) 


2 ! 

j BUCKET SIZE 




10 ; 

; DEF EXTENSION 



YES 

• 

! CONTIGUOUS AREAS? 



YES 

» 

: MORE AREAS? 



NO 

10 : 

; PLACEMENT CONTROL? 

; INITIAL ALLOCATION 

(AREA 

•3) 


2 • j 

; BUCKET SIZE 




10 : 

; DEF EXTENSION 



YES 

• 

; CONTIGUOUS AREAS? 



NO 

* 

; MORE AREAS? 




THE NEXT QUESTIONS DEAL UITH ASSOC KEYS TO AREAS + FILL SIZES 
DATA BUCKET AREA • FOR THIS KEY (PRIMARY AND ONLY KEY) 
FILL NUMBER FOR DATA BUCKETS 
INDEX BUCKET AREA • 

FILL NUMBER FOR INDEX BUCKETS 
LOU INDEX 

THE FOLLOUING QUESTIONS DEAL UITH FILE PROTECTION 
OUNER 

GROUP 

SYSTEM 

UORLD 


.; DEFINE NEU INDEXED FILE 
DEF 099DEF.TMP 

.RETURN 


Figure E-4 . Change Report Form (CRF) File Definition 


P 


E-5 



original page w 
OF POOR QUALITY 


.ENABLE SUBSTITUTION 
.ENABLE GLOBAL 

CREATE DEFINE COMMAND FILE UITH APPROPRIATE PARAMETERS 
.OPEN *3 99DEF.TMP 
.ENABLE DATA *3 
j j; DCU 6/29/31 

j; THE FIRST QUESTION ASKS FOR THE FILE SPECIFICATION. 


•*DBF2' 

NO 


IDX 

FIX, 

yes" 

STR 


NO. 

t'ES 

STP 


.250 

0 
b 

25 


YES 

YES 

NO 

NO 

NO 

NO 

'JALLOC' 

'JEXTEN* 

YES 

''SDFILL' 
'*IFILL' 
'*FILLA' 
'*F ILLS' 


RUED 

^UED 

^UED 


jt » 

« t 
« B 
• • 
B B 


B B 
B B 


B B 
B B 


THE NEXT QUESTIONS DEAL UITH FILE ORGANIZATION 8. RECORD ATTR 
FILE ORGANIZATION 
RECORD FORMA '■ 

RECORD SIZE 

CARRIAGE RETURN CONTROL 
THE FOLLOUING QUESTIONS DEAL UITH KEYS 
DATA TYPE (PRIMARY KEY) 

KEY LOCATION 

KE'i' LENGTH 

I'E'.' NAME • IF AN','') 

DUPE KEYS'" 

MORE KE'.'S? 

DATA T'l'PE iSECONDAY KEY) (FIRST ALT) 

KEY LOCATION 

KEY LENGTH 

KEY NAME (IF ANY) 

DUPE KEYS? 

ALLOU KE'KS TO CHANGE 
DEFINE NULL KEY VALUE 
MORE KEYS? 

THE NEXT QUESTIONS DEAL UITH- ALLOCATION AND PLACEMENT ATTRIBUTES 
DEFINE AREAS? 

PLACEMENT CONTROL? (AREA #5) 

INITIAL ALLOCATION 
BUCKET SIZE 
DEF EXTENSION 
CONTIGUOUS 

THE NEXT QUESTIONS DEAL UITH ASSOC KEYS TO AREAS + FILL SIZES 
FILL NUMBER FOR DATA BUCKETS 
FILL NUMBER FOR INDEX BUCKETS 
FILL NUMBER FOR DATA BUCKETS (ALT KEY 1) 

FILL NUMBER FOR INDEX BUCKETS 
THE eOLLOUING QUESTIONS DEAL UITH FILE PROTECTION 
UUNER 

GROUP 

SYSTEM 

UORLD 


.DISABLE DATA 
.CLOSE #3 

.; DEFINE NEU INDEXED FILE 
dIf 999DEF.TMP 

. RETURNk 


Figure E-5. Component Summary Form (CSF) File Definition 


E-6 



ORIGINAL PAG£ IS 

OF POOR QUALITY 


.ENfiBLE SUBSTITUTION 
.ENABLE GLOBAL 

CREATE DEFINE COnflAND FILE WITH APPROPRIATE PARAMETF 
.OPEN #3 99DEF.TMP 
. ENABLE DATA *3 
! ;j DCU G. 29/31 

!! THE FIRST aUESTlON ASKS FOP THE FILE SPECIFICATION. 


'$DBF2* 

NO 


IDX 

FIX 

YE' 

I TP 


liu 

r'ES 

STR 


79 

0 

8 

21 


r’ES 

YES 

NO 

■f’ES 

STR 


10 


'r’ES 

‘•£S 

NO 

NO 

NO 

HO 

**ALL0C' 

2 

'fEXTEN' 

YES 

''fDFILL' 

**IFILL' 

'SFILLA' 

*$FILLB' 

'SFILLC' 

'$FILLD* 


RUED 


THE NEXT-QUESTIONS DEAL WITH FILE ORGANIZATION «. RECORD ATTR 
FILE flPGANIZATION 
RECORD FORMAT 
RECORD SIZE 

CARRIAGE return CONTROL 
THE FOLLOWING QUESTIONS DEAL WITH KEYS 
DATA TYPE 'PRIMARY I EY) 

KEY LOCATION 

KEY' LENGTH 

KEY NAME (IF ANY) 


DUPE KEYS? 

MOPE KE'i’S? 

DATA TYPE 'SECONDAY KEY) 
KE’i' LOCATION 


fFIPST ALT) 


1 E’l' 

f EY' 


LEfIGTH 

NAME I IF AN’Y) 


P P 
P « 


^ » 
• • 
0 0 

0 0 
t • 
0 0 


0 0 
0 0 
0 0 
0 0 


ku£d 

iuEV 


.DISABLE DATA 
.CLOSE *3 


DUPE KEYS^ 

ALLOW KEYS TO CHANGE 
DEFINE NULL KEY VALUE 
MORE KEYS? 

DATA TYPE (TERTIARY KEY) 

KEY LOCATION 

KEY LENGTH 

KEY NAME ( IF ANY) 

DUPE KEY'S? 

ALLOW KEYS TO CHANGE 
DEFINE NULL KEY VALUE 
MORE KEYS? 

THE NEXT QUESTIONS DEAL WITH ALLOCATION AND PLACEMENT ATTRIBUTES 
DEFINE AREAS? 

PLACEMENT CONTROL? (AREA *5) 

INITIAL ALLOCATION 
BUCKET SIZE 
DEF EXTENSION 
CONTIGUOUS 

THE NEXT QUESTIONS DEAL WITH ASSOC KEYS TO AREAS 4- FILL SIZES 
FILL NUMBER FOR DATA BUCKETS 
FILL NUMBER FOR INDEX BUCKETS 
FILL NUMBER FOR DATA BUCKETS (ALT KEY I) 

FILL NUMBER FOR INDEX BUCKETS 

FILL NUMBER FOR DATA BUCKETS (ALT KEY 2) 

FILL NUMBER FOR INDEX BUCKETS 
THE FOLLOWING QUESTIONS DEAL WITH FILE PROTECTION 
OWNER 

GROUP 

SYSTEM 

WORLD 


.; DEFINE NEW INDEXED FILE 
DiF 999DEF.TMP 

.RETURN 


Figure E-6. Component Status Report (CSR) File Definition 


E-7 


ORIGINAL PACK !■ 
OF POOR QUALITY 


iNAE 


ILE SUBSTITUTION 
ILE GLOBAL 


CREATE DEFINE COrWiND FILE WITH APPROPRIATE PARAMETERS 
.OPEN #3 SSDEF.TrF 
.ENABLE DATA *3 
: DCU 5/29'^81 

:i THE FIRST QUESTION ASKS FOR THE FILE SPECIFICATION. 


'SDBF2' 

NO 


IDX 

FIX 

YES 

§TR 


BO 


'10 

.ES 

STP 


10.8) 

(3.8) 


YES 

'r'ES 

NO 

NO 

NO 

NO 


YES 


100 

10 


804 

950 

950 

950 


^UED 

^UED 

RUED 

k 


THE NEXT QUESTIONS DEAL UITH FILE ORGAN I2ATI0N «. RECORD ATTR 
FILE ORGANIZATION 
RECORD FOPHAT 
RECORD SIZE 

CARRIAGE RETURN CONTROL 
THE FOLLOUING QUESTIONS DEAL UITH KEYS 
DATA TYPE tPKIMAPY KEY) 

KEY LOCATION 


KE'i 

KE 


LENGTH 
NAME • IF 


hM‘i"i 


tFIPST ALT) 


DUPE KEYS' 

MOPE h-EVSr 

DATA TYPE 'SECONDAV KEY' 

KEY LOCATION 

KEY LENGTH 

KEY NAME ( IF ANY) 

DUPE KEYS? 

ALLOU KEYS TO CHANGE 
DEFINE NULL KEY VALUE 
MOPE KEYS? 

THE NEXT QUESTIONS DEAL UITH ALLOCATION AND PLACEMENT ATTRIBUTES 
DEFINE AREAS? 

PLACEMENT CONTROL? (AREA #5) 

INITIAL ALLOCATION 
BUCKET SIZE 
DEF EXTENSION 
CONTIGUOU- 

THE NEXT QUESTIONS DEAL UITH ASSOC KEYS TO AREAS + FILL SIZES 
FILL NUMBER FOR DATA BUCKETS 
FILL NUMBER FOR INDEX BUCKETS 
FILL NUMBER FOR DATA BUCKETS (ALT KEY D 
FILL NUMBER FOR INDEX BUCKETS 
THE FOLLOUING QUESTIONS DEAL UITH FILE PROTECTION 
OUNER 

GROUP 

SYSTEM 

UORLD 


.DISABLE DATA 
.CLOSE *3 

.: DEFINE NEU INDEXED FILE 
DEF 89BDEF.TMP 

.RETURN 


Figure E-7. Encoding Dictionary (ENC) File Definition 


E-8 



liifr^DLE SU&QrXTUTION 
Ei^riEiLE QLOeAL 


ORfCfNAL PAGE IS 
OF POOR QUALITY 


. > CREATE tiEFINE COMMAND FILE WITH APFROPRIATE PARAMETERS 
.OPEN 13 99DEF.TMP 


.ENABLE DATA 


3 


» 

» 

'$D8F2' 

NO 

f 

lUX 

FIX 

120 

YES 

) 

STR 


DCU 4/29/81 

THE FIRST QUESTlOf* ASKS FOP T, ’ILE SPECIFICATION. 


THE NEXT QUE8TI0NC . , > ,:r.i TILE ORGANIZATION I RECORD ATTR 
FILE OROANIZAUu.'. 

RECORD FORMAT 
RECORD SIZE 

CARRIAGE RETURN CONTROL 
THE FOLLOUING QUESTICNS DEAL UITH KEYS 
DATA TYPE (PRIMARY KEY) 


f 

» 


8 

2 


KEY LOCATION 

KEY LENGTH 

KEY NAME (IF ANY) 


NO 

YES 

STR 

» 

) 


0 




‘ 8 


DUPE KEYS? 

MORE KEYS? 

DATA TYPE (SECONDAY KEY) (FIRST ALT) 
KEY LOCATION 

KEY LENGTH 

KEY NAME (IF ANY) 


YES I 

YES ) 

NO » 

NO I 

) I 

NO ) 

NO I 

30 ) 

. 2 f 

10 t 

YES I 

I I 

884 I 

980 » 

980 » 

980 I 

I ) 

I ) 

RUED 

I ) 

RUED 

) ) 

RUED 

» $ 

R 

.DISABLE DATA 
.CLtlSE 13 


DUPE KEYS? 

ALLOW KEYS TO CHANGE 
DEFINE NULL KEY UALUE 
MORE KEYS? 

THE NEXT OUESTIONS DEAL UITH ALLOCATION AND PLACEMENT ATTRIBUTES 
DEFINE AREAS? ’ 

PLACEMENT CONTROL? (AREA «8) ' 

INITIAL ALLOCATION 
BUCKET SIZE 
DEF EXTENSION 
CONTIGUOUS 

THE NEXT QUESTIONS DEAL UITH ASSOC KEYS TO AREAS ? FILL SIZES 
FILL NUMBER FOR DATA BUCKETS 
FILL NUMBER FOR INDEX BUCKETS 
FILL NUMBER FOR DATA BUCKETS (ALT KEY 1) 

FILL NUMBER FOR INDEX BUCKETS 
THE FOLLOUING QUESTIONS DEAL WITH FILE PROTECTION 
OWNER 

GROUP 

SYSTEM 

UORLD 


.( lEFINE NEW INDEXED FILE 
I'EF 0‘?»DEF.TMP 


Figure E-8. 


Estir.ciced Statistics (EST) File Definition 


E-9 



ORIGINAL PAGE IS 
OF POOR QUALITY 


.ENABLE SUBSTITUTION 
.ENABLE GLOBAL 

.: CPEATE DEFINE COMMAND FIlE UITH APPPOFRIATE PARAMETERS 
.OPEN *3 99DEF.TMP 


.ENABLE DATA 4s 


'SDPF2* 

NO 


ii'. . 

•• T ■ 

r , . 

■■ES' 

STR 


112 


833 

950 

950 

950 


DCU S. 29/8 1 

THE FIRST QUESTION ASKS FOR THE FILE SPECIFICATION. 

• 

THE NE;;T QUESTIONS DEAL UITH FILE ORGANISATION 8. RECORD ATTR 
FIi.E ORGAN iZATICN 
RECORD FOPWT 
RECCRD SIZE 

CARRIAGE REPjRN CONTROL 
THE FOLLOWING QUESTIONS DEAL UITH KEYS 
DATA TYPE (PRIMARY KEY) 

KEr- LOCATION 


KEY LENGTH 
kSV name • if 


ANY) 


DUPE KEYS? 

MORE KEYS? 

DATA TYPE ^SECONDAY KEY) 
KE'r LOCATION 

KEY LENGTH 


(FIRST ALT) 


; 

8 

0 0 

KEY NAME (IF ANY) 

fES 


• • 

DUPE KEYS? 

VES 



ALLOW KEYS TO CHANGE 

NO 


• • 

DEFINE NULL KEY VALUE 

i<G 


■ • 

rOPE KEYS? 

• 


• • 

THE NE:T QUESTIONS DEAL 

NO 


• • 

DEFINE AREAS? 

NO 


• • 

PLACEMENT CONTROL? 


30 

« • 

INITIAL ALLOCATION 



• • 

BUCKET SIZE 


10 

• • 

DEF EXTENSION 

rtS 


• • 
0 0 

CONTIGUOUS 


« » 
m » 
» 0 


Pl£D 

^UED i 

RUED 

0 0 

O 

.DISABLE DATA 
.CLOSE #3 


.; DEFINE NEW INDEiCD 
DEF 999DEF.TMP 

.RETURN 


(AREA *5) 


THE NEi-a QUESTIONS DEAL UITH ASSOC KEYS TO AREAS + FILL SIZES 
FILL NUMBER FOR DATA BUCKETS 
FILL HUMBER FOR INDEX BUCKETS 
FILL NUMBER FOR DATA BUCKETS (ALT KEY 1) 

FILL NUMBER FOR INDEX BUCKETS 
THE FOLLOWING QUESTIONS DEAL UITH FILE PROTECTION 
OWNER 

GROUP 

S't'STEM 

WORLD 


•ILE 


Figure E-9. Phase Dates (HDR) File Definition 


E-10 


criicmi. pjit,:. t: 

OF POOR qi/auty 


■NAj 

■naI 


iTITUTIOII 

mi 


CPEATE DEFINE COMMAND FILE <JITH APPROPPIATE PARAMETERS 
.OPEN *3 99DEF.TMP 
.ENASLE DATA *3 


^SDBF2' 

NO 


rES 

§TP 


29 


0 

'SDFILL' 

'SIFILL' 

2 


1 1 
s : 
s s 

I • 

4 j 


DCU •S'SS.’Ol • 

THE FIRST QUESTION ASKS FOP THE FILE SPECIFICATION. 

THE NE>^T QUESTIONS DEAL WITH FILE ORGANIZATION «. RECORD ATTR 
FILE ORGANIZATION 
RECORD FORMAT 
RECORD SIZE 

CARRIAGE RETURN CONTROL 
THE FOLLOLJING QUESTIONS DEAL UITH KEYS 
DATA TYPE i PR I MARY KEY) 

KEY LOCATION 

KEY LENGTH 


DEAL '.JITH ALLOCATION AND PLACEMENT At-'PIBUTES 

'AREA *1) 

•BLOCKS) 


6 

• 

: ! 

KEY NAME ' IF ANY) 

NO 


DUPE ) E'i'S' 

NO 


MOPE KEYS? 

‘.ES 


THE NEXT QUESTIONS DEAL 


DEFINE AREAS' 

NO 

1 

PLACEMENT CONTROL? 

'SALLOC' 


INITIAL ALLOCATION 

■fEXTEN' 

; : 

BUCKET SIZE 


DEF EXTENSION 

YES 

t 

CONTIGUOUS AREAS? 

YES 

: i 

MORE AREAS? 

NO 

i i 

PLACEMENT CONTROL? 

2 


INITIAL ALLOCATION 

2 

• 

BUCKET SIZE 


!• 

DEF EXTENSION 

'LES 


CONTIGUOUS AREAS? 

'VES 

« 

MORE AREAS? 

HO 

1 

PLACEMENT CONTROL? 

2 

• 

INITIAL ALLOCATION 

2 


BUCKET SIZE 

2 

• 

DEF EXTENSION 

YES 

; : 

CONTIGUOUS AREAS? 

HO 

$ 

0 

MORE AREAS? 


0 0 
s t 

• • 


^UED \ 

^UED '* 

^UED ' 

k ' 

.DISABLE DATA 
.CLOSE NK3 


DEFINE HeU INDEXED FILE 
DEF 099DEF.TMP 

.RETURN 


(AREA *2> 


(AREA *3) 


DEAL UITH ASSOC KEYS TO AREAS ♦ HILL SIZES 

... iA • FOR THIS KEY (PRIMARY AND ONLY KEY) 

FfLL NUMBER FOR DATA BUCKETS 
INDEX. BUCKET AREA t 

FILL NUMBER FOR INDEX BUCKETS 
LOU INDEX 

THE FOLLOUING QUESTIONS DEAL UITH FILE PROTECTION 
OUNER 

GROUP 

SYSTEM 

UORLD 


THE NEXT QUESTION* 
DATA BUCKET ARg 


Figure E-10. Growth History (HIS) File Definition 


E-ll 



ORIGINAL PAGE 19 
OF POOR QUALITY 


.ENABLE SUBSTITUTION 
.ENABLE GLOBAL 

CREATE DEFINE COMMAND FILE UITH APPROPRIATE PARAMETERS 
.OPEN #3 99DEF.TMP 
.ENABLE DATA #3 

t 


•*DBF2* 

NO 

'IDX 

FIX 

53 

YES 

Itr 

0 
8 


NO 

•I'ES 

'SALLOC' 

2 

'JEXTEN' 

YES 


YES 

NO 


YES 

NO 


YES 

NO 


10 

2 

10 


10 

2 

10 


0 


'SDFILL' 

*$IFILL' 

2 


RUED 

^UED 

^UED 
0 
R 

.DISABLE DATA 
.CLOSE *#3 


DCU 6/29/31 

THE FIRST QUESTION ASKS FOR THE FILE SPECIFICATION. 

THE NEXT QUESTIONS DEAL WITH FILE ORGANIZATION 8. RECORD ATTR 
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Figure E-12. Re-aource Summary Form (RSF) File Definition 
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Figure E-13. File Name and Status (STS) File Definition 
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File Definition 
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APPENDIX F - SAMPLE DATA COLLECTION FORMS 


The forms reproduced here are used by the SEL at the Goddard 
Space Flight Center to collect data on development proj- 
ects. The terms used in these forms are defined in Sec- 
tion F.2. 

F.l SAMPLE DATA COLLECTION FORMS AND INSTRUCTIONS 

This section contains sample data collection forms and 
instructions for their use. The instructions precede the 
forms. The following forms are included: 

1. General Project Summary (GPS) 

2. Resource Summary Form (RSF) ' 

3. Component Summary Form (CSF) 

4. Component Status Report (CSR) 

5. Run Analysis Form (PAF) 

6. Change Report Form (CRF) and Attitude Maintenance 
Change Report (ATM) 
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INSTRUCTIONS FOR COMPLETING THE GENERAL 
PROJECT SUMMARY - FORM 580-1 (2/77) 


This form is used to classify the project and will be used in conjunction with the other 
reporting forms to measure the estimated versus actual development progress. It should be 
filled out by the project manager at the beginning of the project, at each major milestone, 
and at the end. Numbers and dates useu at the initiation of the project are assumed to be 
estimated; intermediate reports should change estimates to actuals (if known) and update 
estimates. The flnal report should accurately describe the system development l.'fe cycle. 

A. PROJ EC r DESCRIPTION 

Description. Give an overview of the project. 

Inputs. SpeciHcations and requirements (etc.) of project. Give the format of these. 
Requirements. How requirements are established and changed. 

lYoducts Developed. List all items developed for the project (e.g., operationul system, 
testing system, simulator, etc.). 

Products Delivered. List all items required to be delivered (e.g., source . f the oper- 
ational system, object code of the operational system, design documents, etc.). 

B. RESOURCES 

Target Computer System. System for which software was developed. 

Development Computer System. System on which software was developed. 

Constraint! List any size or time constraints for the finished product. Do you antici- 
pate any problems in meeting these constraints? 

Useful Items From Simitar Projects: 

1. List previous projects, which will contribute various aspects to this project. 

2. For each project, give the percent of the current project it makes up in each 
of the 3 listed aspect! 

3. For each of the 3 listed aspects (specification, design, code) check what level 
of modifications are necessary. 

C TIME 

Start Date. First date of work, including design and modification of the speeitlcation! 
End Date. Delivery date. 

Estimated Lifetime. Estimate the operational life of the system. 

Mission Date. Scheduled operation date of the system (write unknown if not known or 
undecided ye: on any of these dates). Date project must be operational. 

Confidence Level. Give the percent probability you think the end date is realistic. 

(e.g., 100% means certain delivery on that date, 0% means no chance of delivery.) 
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D. COST 

Cost. Total amount of money the project costs, including both contract and in-house 
costs. 

Maximum Available. Maximum amount available, independent of what estimated cost 
is. 

Confidence Level. Rate percent reliability in cost estimate. 

How Determined. At imtiation how is it estimated, at completion how is it calculated. 

Personnel. Give the number of full lime equivalent per.ons required at inception of the 
project, I ii of the way into the project, 2/3 of the way into the project, at the com- 
pletion of the project. 

Total Person .Months. Give the total number of months that full time equivalent per- 
sonnel i managers, designers, programmers, key punchers, editors, secretaries, etc.) are 
assigned to the project. Oo not include all overhead items such as vacation and sick 
leave. 

Computer Time. Give the total number of hours on all systems normalized to one 
machine (e.g.. the IBM 360/75) and name the machine. 

E. SIZE 

Size of the System. Include the total amount of machine space needed for ail instruc- 
tions generated on the project plus the space for data, library routines (e.g., FORTRAN 
I O package) and other code already available. Break down size into data space and 
instruction space. 

Confidence Level, Rate percent reliability in size estimates. 

Total Number of Source Statements. Give the number of FORTRAN, ALC, or any 
c;hui language instructions generated specifically for this project. 

Structure of System. Give overall structure of system. Is it a single load module, is it 
an overlay structure, or is it a set of independent programs? For overlay and separate 
programs, give the number and average size of each 

Define Your Concept of a Module. Give the criteria you are using to divide the soft- 
ware into modules. 

Estimated Number of Modules. Include only the number of new mod.4es to be written. 

Range in Module Size. Give the number of instructions in the minitnurn. maximum and 
average module and the bnguage in which they are wiitteir as a i cference. 

Numlier of Different I/O Formats Used. Give the number of distinct external data sets 
that are required fur the system including card reader, printer, graphic's device, and 
temporary flics. 

F. COMPUTER ACCESS 

A librarian is a person who can be used to perform any of the clerical functions associ- 
ated with programming, including those given on the chart. Check the appropriate boxes 
for those persons who have access to the computer to perform the given fu.ictions. Give the 
percentage of time spent by each in batch and interactive access to the computer. 
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C. TECHNIQUES EMPLOYED 

For “level, “ specify to whet level of detail in the flnished project the technique is used. 
(e.|., subroutine, module, segments of 1000 lines, top level, etc.) 

Spccificstions 

Functional - Componem;, .De Jescribed as a set of functions, each component 
performing a certain acti-' , 

Procedural - Conipone'ftx . .tCieA in some algorithmic manner (c.g., using a 
PDL). 

English - Components are specified usi.ig an English Language prase statement of 
the problem. 

Formal - Some other formal system is used to specify the components. 

Oej(«ii and Development 

Top Down - Tlie implementation of the system one level at a time, with the current 
level and expansion of the yet to be defined !. tbroutines at the previous higher' level. 

Bottom Up • The implementation of *he system starting with the iowest level rou- 
tines and proceeding one level at a time to the higher level routines. 

Iterative Enhancement - The implementation of successive implementations, each 
producing a usable subset of the final proiiuct until the entire system is fully 
developed. 

Hardest Pint - The implementation of (he most difficult aspects of the system first. 
Other • Describe the strategy used if it is not a combination of any of the above. 
None Specified - No particular strategy has been specified. 

Coding. The final encodi ''g of the implementation in an executable programming 
language. 

Structured Code With Simulated Constructs - The language does not support struc- 
tured control structures (e.g., FORTRAN) but they are simulated with the existing 
structures; please state the structured control structures you are using (e.g., WHILE, 
CASE, IF). 

Structured Control Constructs - The language supports structured control struc- 
tures (e.g., a FORTRAN preprocessor) please list structures you are using. 

Other Standard - Describe any other standard you are using. 

None Specified - No particular strategy has been specified. 

Validacion/Verification. Testing: execution of the system, via a set of test cases. 

Top Down > Stubs or dummy procedures are written to handle the yet to be imple- 
mented aspects of the system and testing begins with the t<;p level routines and 
proceeds us new levels are added to the system. 

Bottom Up - Check out of a module at a time using test drivers and starting at the 
bottom level modules first. 
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Sirukiure Driven - Using structure of program to determine lest date (e.g., every 
statement of program executed at least once). 

Specification Driven - Using specifications of program to determine test data (e.g.. 
all input out put relationships hold for a set of test data). 

Other - Descrihe any other strategy you are using. 

None Specified - No testing strategy lias been specilled. 

Validation/ Verificaiiun. Inspection: visual e.xaminaiion of the code or design. 

Code Reading - Visual inspection of the code or design by other programmers. 

Walk Throughs - Formal meeting sessions for the review of code and design by the 
various members of the project, for technical rather than management purposes. 

i’rooiM - Formal proofs of the design or code, please specify the icchnK(ucs used, 
e.g., axiomatic, predicate transforms, functional, etc. 

None Specified - No inspection techniques have been specified. 

There is some space given to permit the further explanation of any of the strategies that 
may be uted. 

H. FORMAL NOTATIONS USED AT VARIOUS LEVELS AND PHASES 

Give tlie phases (e.g.. design, implementation, testing, etc.) and levels (subroutine, 
module, segments of 1000 lines, top level, .‘c.) at which any type of formalism (llowchart, 
PDL, etc.) will be used in the development of the system. 

I. AUTOMATED TOOLS USED 

Name all automated tools used, including automated versions of the formalisms given 
above and compilers for the programming languages used, and at wnich phase and at what 
level they are used. Include any products that may be developed as part of this project 
(e.g., simulator I. - 

J. ORGANIZATION 

Describe how the penonnel are subdivided with respect to responsibilities into teams 
or groups, giving titles, brief job descriptions, the number of people satisfying tlut title and 
their names and organizational affiliations if known. 

K. STANDARDS 

List all standards used, whether they are required or optional, and the title of the 
document describing the standard. 

L MILESTONES 

Give the phase at wliich management may check on progress of the development of the 
system (e.g., specification, design, implementation of version 1, etc.). Slate also the date at 
which it should take phee i.st completion of the project), how it is to be determined that the 
milestone was reached, who will be responsible for reviewing the progress at iliat point and 
what the review procedure will be. Also give the resources used since the last milestone. For 
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size of system jive the current size of the system at that milestone. Each milestone has 2 
confidence teveis, one for time estimates and one for resource expenditures. For estimated 
future milestone, the first confidence ievel for the probability of reaciuns the milestone at 
that date. The second is for the .’'ccuracy of the resources sued. For past milestones, the 
flnt confidence level Is normally 100% (actual date) while the second is an estimate on the 
accuracy of the accounling system. 

M. DOCUMENTATION 

For each time of documentation developed, state the type of documentation, its purpose, 
the date it should be completed, its size and list any tools used in its production. (At the 
beginning of the project these shouid be estimates, at the end of the project, they should be 
accurate figures.) 

N. PROBLEMS 

Give the three most difficult problems you expect to encounter managing this project. 
Pleue be as specific as posslbic. 

O. QUALITY ASSURANCE 

To what do you attribute your confidence in the completed system. Be u specific u 
possible. 
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OF POOR QUALnV 


j L IMLIITONIS 

I ttMmmtmd I ^.1 

I H.MI 

WtlaMUtl 

I bpwi^ltiifM! Cow bfMn Mpfitht ______ Comfutw Tim* _____ h> 

S^ii •! lyittm _______ ContManw Ltvtl ______ 

n«t« ___________________________ litiraiid OtM _______________ e»n(WMM Lw«( 

Hqw Ottarmnid 

RmImhwi - - . - - - . 

Rtportini I^OMdiiia ________________________^__________^___________ 

! Rmowm IxptmUtutM: Coit ______ •tnon MonitM _____ Compuw Tim* ______ hra. ______ 

^ tin of Iviimh _____ CenfMwMi Lt¥t( ■ 

niMt _________________________ iitinwttO Ooio _______________ ConfWtnoo L«tf. 

How OitirniintO — ■ - - -■ - 

R«*i«wwt ■ 

Roporiini ftoeoduro ____________________________________________ 

Rmurot Ixp«n0iiur«! Cow l*trion Monthi _____ Computir Timt ______ hfi. ______ 

(lilt of lymm _____ ConfMtnco L«vtl ______ 

I Wmo OMiiMfrf n«f ConfMomo Lwoi 

How Uttorminod 

Rtviowm - 

Ropoitini frootduro 

fUwurct fxptndiiurtf : Coil _____ Pmwn MonilM _____ CofflPMttr Timo ^___ Iwii n 
litf of Syiitm _____ ConfMonco Lmof _____ 
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w»o«o ■■ twf ConfMtnoo Lwti 

How DturmiiMd ■ 

RMitWWI - - 

Rtponlm fteoidurt ____________________ -- 

Romutm bptnOlturM! Colt _____ Pwion Monthi _____ Computii TinM ____ 

Siitef lyitMn____ ConfMinw Lml ______ 

Wioto OwliiifO Oaf eaidlOwi— Liial 

How Oitirminod _________________ 

fiMliwin ■ 

Ripoitinf frooiduro — 

RoMiitM fspindiiuroi: Cow _____ Rinon Momhi ____ Compunr Timo _____ Imi. _^___ 
Siitof lyilom ____ ConfMonot Lml - 

w«M« owiwfo Ht« ConfMonoo Uyit 

How Oitirmlnid — 

Rwiiwin . 

Riporting fyoeiOuro _____________________________________________ 

Rmowm Expwdlturiii Coil _____ Ruion Monthi _____ Computir Tlnw ______ hri. ______ 

Slit of Syittm _____ ConfMonot Ltitl 

Phiit ____________________ Eitimtitd Out ______________ ConiMtntt Ltvtl 

How Ottirmlnid - 

Rtvitwtil . ■ . . 

RtpoMing Procidurt - 

R'Routro' Eiptndlturti; Con _____ Ptrion Monthi _____ Compunr Timt _____ hri. ____ 
Slit of Syittm - ConfMtPCt Ltvt<_____ 
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ORIGINAL PAQi W 
OF POOR QUALITY 


INSTRUCTION! FOR COMPLETINO TNI COMPONf NT SUMMARY 


Thu 'i'M» » u»*il li' ttKl> ol !h» ol » iyiittii A couHtontm >\ t putt uV lh» (vit«ip I'V 'Ur« Of 

coinippn III ’.ciiijn g.. iii «mfv 'i' * pm cltin or lMi«lm« iti«giim tor th# ivMtni 41 4i'V piJU’l in iitn* or t ihirtil rtciion of diia luch 
o 4 COMMON mook) With th« intorm4liun ort thit lonn combinaO with th« intoruNtion on iht Coinpon«ni Statut Rtpori, thi iiiuc 
tura and ttaiui ot th* iviltnt 4itd ut tMvalopmant cait b« monitottd. 

T*i t i.Mni I'unilil l<* f 11*0 out lor » 4 i;fi I’Oinponini 4 t th» lona that th# con'ti.' >»nt u v1#l"'»<l Jt the t.nvi >1 ii cpinpicttit ami at 
mv I'O'i't 0 tuna whan a maioi mooilication to th# coinponant •» mart# II ihoolil h# ’illaO out liv th# wrtoo lattioniilil# 'or Ih# com 
VMittnt 

PROJICT. Uiaa p« 0 |«ct nani#. 

DATE. Oiv# Oat# (orm lillati out 

NAME OP COMPONENT Ciiv# nam# (up 10 8 CharaCI#rit by which th# comtwnam wul tw i#t#ir#a to m oihar tormi 
BHIi F DESCRIPTION Slaia function ol coinpiinant 

TYPE OF SOFTWARE Chack all ciauiticat oni that apply AH common hiocM ar» laoaiaia conipoi'«nit. 

STATUS OF COMPONENT Ohack wh«ih»r thii ii a n#w coinponant. vyha’nar it u a coinponant undar davalopmani (a g., a piavioui 
coinponaiw tuininary hai alraadv baan lulNitiitadl. or whaihar tha cornpcnant ii now complata. 

A. CODi SPECIFICATIONS. Ci«a tha tomt ol dHign tor thii coinponant, and tall to whai laval of daiail tha iptcihcaitont ara gnran, 

Ppnatlonai-Componanii ara daiciibad ai a lat ot (unciioni, aach componam parlorming a ctrtain action. 

lhacadural-Cotnponantt ara iiMCitiad in torn# algorithmic mannar la.g , uiing a PDL). 

Engliih-Componamt ara ipacitiad uii ig an Engllih Languaga mota tiataniant ot tha problem 

Pormal-Sonia othar tormal nyilam ii uiad to ipacity tit* componantt. 

Ralativa to tha on# davalcping tha contponani. rata tha praciiion ot tha iiiMGitlcationt Va;y praciit maani that no additional analyiii 
on tha problam n naadad, praciM inaam that only aaiy or trivial idaai hava to ba davalopad, and imprKiia maani that much work Mill 
ramaim in davalopmg thia componant and ita bane aiructura. 

■l INTERFACES 

Qiva tha ralativa poaition ot thia componant in tha tyatam. Givt tha numbar and hat tha namaa ot ail compontnti thai call thii 
componant. and ara callad by thit componant. Alao, giya tha namtt at any compontnta or othar ittmi thit componani iharat with 
othar componantt la.g., COMMON btocka, aktarnal dtial. Tha componant# dlraetly dttcandad from thit componant ratara to tha iraa 
chart or tha tyatam. It tha intartacaa ara not yat complata, chack “Not Fully Spacitlad". 

C. PROORAMMINQ LANGUAGES 

Liti languagta (or attambly languagtti to ba uaad to implamam thit componant. It mort than ona. liti pavetmagH ot #Kh (In 
linaa ot tourca coda). It thara at# any contirainta on tha componant la.g., alia, akacution timal Hat ihtm. Alto givt aatimtitd ana ot 
tiniahad componani in tarma ol touica ttaiamania. iaaiimata liia with commanta and without cpmmanii) and raiullingmKhIna lan^ 
gukgaa (including data araaa, but not COMMON blockal. 

UmIuI Hama Prom Similar lYetaeti 

I Lilt pravioua compontnia and ptojacTi which contribula varloui aipacta to thia componant 

2. For aach luch componani, giva iht paicam ot aach ot tha ihrta liitad aapacta it makM up la.g., a componani may ba 60\ ot 
daaign but only 2Btk ol coda dua to changad intartacaa. ate.). 

3, For aach ol tha ihraa liiiad tapacia, chack what lavat ot modilicaiiona art nacaaaary. 
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0. COMPLEXITY 

Haii yoM twliaf in tht compltxity of tni impitnMntttion. Alio APproKtmm tn« numb«r Ibv S) of tinQnmtnt typt ittumenu 
(input icfitnwnu ir» includtdl, and eoncroi ittwmann (ttiow (hai ilnr tn« flow of control, i.g., IF. CALL, GOTO) The tum of thtie 
two inay not b« tOO^ (t.g., CONTINUE, DIMENSION and HEAL natamanti will not ba countadi 10 and daclarationi ihould ba 
listed as other. 

%. RESOURCES TO IMPLEMENT 

For each of the three lilted phaiei lOeiign, Code, Teitl, eilimate computer 'uni, time needed, hours to implement, ana estn 
mated completion date. If no: known, ur no estimate can be given, write "unknown", 

F. OIMQIN OF COMPONENT 

If thii component ii independent of any other component of the lyitem (e.g., is a low live! component which is designed first, or 
is the root node of the tree chan) then check yet, otherwise check no. 

If no is chKked, then explain why the component was added. (Ututllv only one reason wlli be chKked, although more may be 
checked, it appropriatel. 

A lower level eleboretion of a higher level component means that an existing component was expanded to include new compo’ 
nents le.g., expanding trr,a chart). List tha higher lave' copiponent time. 

Added at a driver or interface meant that a catling program was added to call axisting componantt. Li'it thata eallad components, 
A ratfatign of an axisting component meant that new capabilities were added to an already axisting r>omponam. Write Its name. 

A renaming of an oidar componani. Qiva tha old name. 

A ragmuping of existing matarial meant that saveral component Mra ndatlgnad with a ness compoitent rtsulting from this re* 
design. Gva the old component namats 

Type of addition. Why wai this oompenam added to die syttam at this dma? Cheek the apisroprlaM raaaon. (Normally, only 
one should ba chaefcad, aldtou^ more can ba if appropriate.) 

Q. ADDITIONAL COMMENTS. Add any other comments dsat witl help axpliin the purpom, design, and comptaxiiy of this com* 
ponant 

H. FERtON RESFONtllLE. Induda name of parson ittpontibit for Implamantingcomponant 

1. PEREON FILLING OUT FORM. Giva nama of parson ftiting out form. This normally it tha tsma nama as in H. 
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COMPONENT SUMMARY 


PROJCCT 

OATP 

NAM I OP COMPONENT 

CREATION BATE 

IRIEE DECCRIPTION 

STATgg nc ^VPQNf NEW 

IINOEH neuE^ ,, <;^»MB||TEp 

TYPE OP SOPTWARE (Check All That Apply) 


Proceaaing 

__^Syiterii Related 

___ Algorithmic 

DATA/COMMON Block 

1 «gu^ Control 

.i— Other 

A. CODE SPECIPICATIONS (Check All That Arply) 



I 


LEViL 0^ DETAIL 


FORM OP DESIGN 


Cpmponfnt 



Funetionii 


roctduril 


Engllih 


; For(n»l 


F’Miiion of Co<l« SpKifIctiion V«ry Pfociw.. , ■ Pi 


B. INTEDPACES 
Niimbtr Compontnti 

Nymtoor Cllling Thii r/>mp«o«nt M«m«. 

Number Sbvtd m«hm« 

Nuinbor of Compononti Oiroctlv OttCKi-idtd from Thb Componont. 


C. PROGRAMMING LANGUAGES 

1 angiiagM Iliad mntt Parranta^ ( 

.1 11 


CONSTRAINT PROBLEM EXPECTED; 

1 Constraint 

Ccdtponant Mwti 


Present 

Conitrsint 




Erecutlon Time 


Sizt: Source Staumenn llr^eluding Commemi) 

Source Stitemenu INot Including Commenti) 
Useful liemi Prom Similar Proieeti 


Component 


Specification 


Major 



. Impradie 


_Not Pully (^cifled 
_Not Pully Specified 
__Noi Pully Specified 
—Not Pully Specified 


Machine Bytea 


Deiign 


Minor 
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D COMPLiXITV 

Comploiitv of Function Etiy ________ Mruittmta Utrii ...... - ■ 

> Aisignmtnt simmintt Control SUMmcnti a Oth«r Siiitn‘«<tu Diti Ceel i (.<) 


E. nCSOURCES TO IMPLEMENT 


1 ► 1 

Computer Time (min) 

Effort (hrti 

Eit. Completion Cate 

j 




[Co.*** . 




t 





f. Ii thii cumpontni inotp«nd«m of iho •xliiing componomi?. 


-Vti. 


.Mo 


If No, dtKfib* rtittion of iltli compontni to tfw ixliling lyittm: 

.initrtid Jt » low*r Itvil rtiborition of hightr Itval comoontnti 
.(00«d ti t driver or mtirfic* for editing componentt 
.J n,‘d«sign (to Jdd ka CjOibilitvl of editing componfnti 
. 'eneming of exntiiig comoonent 
.regrouping of editing metiriel frorn levtrel comoonenti 
.other 


Inameil. 

(nimeiL 

(nemeil. 

(nemef_ 

(nemeil., 


Type of Addition. 

___ error correction 

planned enhancement 

___ Implementation of requirement! chenge 

___ improvement of clarity, maintainability, or documentation 

___other {explain below) 


.Improyement of uier larvioe 
.utility for development purpowi only 
.optimitatlon of time/ipKe/aeeuracy 
.adaptation to environment change 


G. ADDITIONAL COMMENTS 


H. PERSON RESPONSIBLE FOR IMPLEMENTING COMPONENT. 

I, PERSON FILLING OUT FORM 

!§'*•! te/rat 
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INITRUCTIONI FOR COMFIITINO THI COMFONINT ITATUS RIFORT 

* TMi form it to bo uttd to •eeurattiy kotp irocfc of iht doMlopmoni of aocb oomponom In tht lynom. A Compononi lummtry 
Rapori ihould txiii for oKh componont momionod. Tho form it to bo tumod in tt tho ond of okH wook Flotio fill out oithor dtily 
or onco tiefi wook. If dtily, thon i givon componont moy bo Htiod tovorol timot during tfio ceurio of o wook. For OMh componont 
litt tho number of hourt tponi on OKh of tho lilted ictivitin. Thit form ihauW bo filled out by portont working on tho proioct. 

FROJiCT. Nemo of the proioct. 

FROORAMMIR. Nome of progrimmor. 

OATI, Otto ropon turned in. Uiutily tho dito oft Friday. 

COMFOKINT. Nome of componont. Either t part of the lytttm ttructuro for which there It a componont tummary form, or one of 
tho following: 

ilCL. Oovtloping command language inttructioni. 

Oyorlty, Developing lyvtim overlay ttructuro. 

Uiw Quida. Uiar'i Guide Oocumantation. 

lytiom Dotcriptlon. Syittm Ooicriptlon Documentation. 

OECION 

Crotto. Writing of a component dotign. 

Rtad. Reading (by pearl of dotign to look for errort. (e.g., peer rtviewl 

Formal Review. Formal meeting of leveral Individual! for purpote of explvining deiign. Alto include time ipent in preparing for 
review Alt thoie attending review thould Hit componenti diicutiad in their own Component Statut Report for that week. 

COOI/OiVILOFMENT 

Code. Writing OKoeutable Inttructiont and detk checking program 
Read. Code reading by peer. Similar to Dotign Retd above. 

Formal Review. Review of coded componentt. Similar to Dotign Review above. 

TESTING 

Unit. Unit totting. Tettrun with lett data on tingle module. 

Integ Integration totting of teverel component!. 

Review. Review of totting itatut. 

OTHER. Any other ttPMt related to a component of the proioct not already covered other then Onign, Code Oavilopment, Tett 
(e.g., Oocvmkntation of a ipeeiflc component). Lin type of Mtivity, and hourt ipent on that Ktivity. A tot of Ktivi'let hat been 
litted for which time may be chanjed to the overall project: 

Travel. Tima ipent on official travel related to thit proioct, linetuding tript lo end from GSFC). 

Forme. Time ipent on filling out reporting formi. 

Mentingi. Time ipent in mMiingi which are not deiign or code review moetingi. 

Training. Training activitiet Identified for proiect. 

Aee Ten. Acceptance Teiting activitiet. 
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INITRUCTIONI FOR COMRLITINQ THf COMRUTIR PROQRAM RUN AINALYIII FORM 

Thii form will b« uxtf to monitor tht ictivitMt for wfiicfi tfw eomoutir ii uM m tfw <»ur» of • oro/tct lifo eyett. An omry inouM 
bt miOt for HCh oomoutor run>lnelu4ino til tct'ViliM ptrformtO whtn tho cBmputtr it uttd <n in ir.iirMlivi modi, 

MOQRAMMIR. Writ! down mmi of orton prioirinf eomoutir rum. Tfili imy not mcHiirltv M the pirion runnini ihi profrim 
(i.i„ HOrimn). 

fROJIfiT. Writi down proHot nimi. Uti • diffirint form for Moh projiei. 

COMfUTIR, Indicitt tfM micfilm on whieh ihiii rum wiri nwdi (i.i., I/3M, fOP*11, SB). 

DATI. Oil! form turnid in. 
fOI ID. Idintiliciiion of too. 

RUN DATI. Out run tubmitlM in formtt MM-00 (montfvdayl, 

INTIRACTIVI. Plici in X if tfM run wii wOmittid from in intirietliri tirmlnil. 

RUN RURROBI. niei in X in ill bOiH thii diiaibi thli run. 

Unit Tut A purpow of thi run it to tnt om or mori eompomnit without tiM mt of tfM tyttim biini oonfifurid Into Ihi loid 
moduti. A run which util I 'tilt driver' would lill into thit oiti|orv. 

Syttim Tm Thu run Mieuiii i loid moduM which oentilm ill of thi currently iviilibli lyitim in order to tmt om or more 
componinii in i full tyitim confliurition. 

Binchmirli Tm Thu n a rietrtificttlon type run. A run that hat tueemfully wicutid in tm pin it now rerun to vrify that 
certain ctptDilitiei mil exiit. 

Miintemnci/Utility. A purpoie of thii run it to perform a 'library type' funnion. Btamplet are runt that update wurea, create 
bacKupa, daitte/eompreti/oopy data leti. 

Compile/AiiamMy/Unk. A purpoie of tm run it to cheek lor errori in iN compile, citemhly and/or link nepa. A run which im 
ciudH one or more of tmie nepa limply at a prareounite to a lyitam aiiaeution would mi fall into thla miw y. 

Oebua Rua Thii run wat lubmiticd in order »/'ttiigata a known error. 

Other. Thii run hat a purpoia which doet mt ici! mio pm of tm othar cataBoriet. iaampln era runt which leceN other lyncmi 
in order to aid in tm daiipn, devtiopiTMnt am/or tettinp of tm projeet under itudy. 

COMRONBNTt OF INTIRCST. Lilt all oomponanti important to thii run Irp., componanti bainf tettid, oompiled, copied, etc.) 

FIRST RUN. Flaee an X here if thii it tm firtt dme any of tm lined componanti have been proeaiaad by tm computer for tm pur- 
ooie of run ipKiflad. 

MBITS OBJICTIViS Thii ii a tubjactive evaluation of wheihar tm run utitfied your obleetivai. Rum tmt iirmimta In errori may be 
latiifaetory if the obiaetive wai to locate errori or to ten for oorrectneii! rum that tarmimie normally may be umatiifaetory if tha pur> 
poia wai to locate an error known to be preiant. Thui thii quanion li Independem of whether tm program comalmd any arrc'i or mt. 

RUN RliSULTI. Check tm box tmt but dMcribH tm rMulti of thii run. Normally only om box ii checked, although nmra tmn one 
may be checked If appropriau. 

Go o d Run. Frogram ran to termimtion with m known arrora 
Setup irrer, Error in oeating program deck. 

Submit Error. Deck lufamitted imorreetly, retourcaa unavailable, keypunch error, or gemral tubmliilon error. 

JCL Error. JCL itatemeni incorrect IJCL cardi minyped ihoukf be lined under lubmit arrort) 

nrfMw Setup Error, Such at imuffldent ipace or time ipceifiad lor job itep. Thli ihould mt be eauiad by program error. 

Machim Error. Errori ouuida of tm oonuol of tm programmer. 

Hardware Error, Machim malfunetion. 

Software Error. Syitem craih or lynam program error la.g., error In FORTRAN compiler |, 

Frogram Error. Error cauiad by tha lubmittad program. 

Compile Error. Tm lource program oonuim an error which It found by tha eompllar or aiaamblar. 

Link Error. The loader or linkage editor findt an error. 

Execute Error. Synam error metiagei are genwated during tha axaeutlon nap. poiilbly eauiing an abend. 

Uier Qanaratad Error. Tm program tarminatci in a programmer ganarated error menage whieh ii mt a lyttam error. 

Ran to Completion. Tm program terminated with no error menage; however, tm reiulti are Incorrect tignifying tmt there ii 
lomathing wrong with tm program. 

COMMENTS. If you believe tmt your antweri to thaia queitioni do mt adequately eharactarita thii run, you rmy add any additional 
oommenti tmt you with. Alto uia thii ipaca to imieata if tm run wai Ion before you had a emnea to evaluate reiulti. 


a 
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iNtmueriONt roN com^litiim thi cna«mi mraiiT porm 


Thii form it utod to kofp troek of *11 efMnfn midt lo a lyiitm. A ehanfi it any afiarailon lo tfia dtiifn, doa dw a n tatlon, or aoda 
ftnaratad tor a proiaci. f Kh ehania aan ba thoo|ht of at a ttto In ttw procaai of tramformini tho orif not totlwaro daii|n Into a com 
oftit ymrkinf lyitam. Tha mitlaf oraaifon of laationi of fratfi coda or daiiin it not a cfiania. 

Ont ckan|f raoort form tkouM bo filiad out for aaab ot>an|a. Whora icMril ebanfN art modt ilmulianaouiiy for dif ftrtni raa- 
tom a Moarata fvm itwuld ba comolatad for aach raaton. 

NUMMN. A unlqua idamifitr par form par day eontlKint of miiiali foMowtd by a laduanaa nui^ibar, Tbt initlali itwu'd ba ifiota of 
tna ptrion filllni out tha form. Tha taquanca numbar tfiould ba a petitiva Iniaitr indieatlnt tfM numbtr of forms flllad out to far dur- 
in« tha day Numbtr OWWOI indicitat tha firit form of tha day flllad out by OMW, OMM09 it tha taeond form that day. ate. 

MOdICTNAMI. Tha nama of tha davtiepmant proiact. 

eURIIINT OATI. Tho data on whioh an antry It firtt n ado on tha form, t*an if tho form it not oompiatod on that day. 

UCTION A-IOINTIPICATION 
fllAIQN, Ixplainyyhy ihaahanititbaintmadt. 

OlICNidTION. Uaterlbt tha ehanfo that li boinf mada. Thit thould not bo on tha variablo noma or bit Itvaf. but ihould ba luffl- 
cionily abitract to that tha function of tha ohanf^ coda eon ba dottrminad, t.f., “tha Input buffar wai elaarad," rathar than "array 
buff wm Nt to laro.” 

IMICT. What eomponanu (or dooumontil art ehanitdf UitthanamHOf alleomponantaanddocumontimodifitdaipartof tha 
ehanfo, inctudinf varilon numbtri. 

f PPORT; What additionai componanti lor doeumantii Mart aaamlnod In dtttrminint what ehanfO wot ntodtd? Lift all eomponanti 
and documanti that wtra axamlnad, but wara not actually ehanitd. in dKidIni what chanfo to make, how to makt it, and whtrt to 
makt It. Thii litt thould not ovtrltp with tha tilt of componanti and documanti actually ehaniad. 

OATH OT CHANOE. NMd for chanoa daiarmmad on. Oiva tha data on which it wh firn rHiliad that a ehanya wti naadad. 

Changa itartad on. Oiva tha data on which tha chania wai itartad. 

What WM tha affon in panon<tima raquirad to undantand and Implamant tha chaniaf 

Oiva tha bMt availabla aitimata of tha total tima naadad to undamand what shanya had to ba mado and how to mako it. Inelud- 
iny tha Implamcntation tima. Thli ihould includa tho timo of all panam invoiyad In makirif tha ehanya. Ai an acampla, if two paopia 
each workad 6 hours on tho ehinia, tha ipaea markad "ona day to 3 dayi" ihould ba ehackad. 

UCTION l-TVN OP CHANQI 

Chick tha ona boa that bait daieribai tha changa. If none of tho changa datcrlptlom warn to fit, chKk othar and glva a daullad 
dMcription of tha changa in Section I. If lavaral of tha dawriptioni Mam aqually appropriata, mora than ona boa may ba chaekad. 

Error Corraation. A changa mada to *orract an arror In pravioui work. If thii boa ii chaekad Sactioni C and 0 of tha changa raoort 
form Ihould ba eomplatad. 

Plannod Bnhaneamam. Tha InMrtion of a body of coda Into a program itub that waa Initially craatad at a dummy for tatting purpotai, 
or adding eapabiiiiy to an ilraady laiiting componani h part of a plannad Ineramantal davalopmant. 

fmplamantatlon of Raguiramanti Changa. Aliaring tha lyitam to conform to a change in raouiramanti impoiad by tha cuitomar. 

Irnprovamam of Clarity, Malntainabitiiy.br Doadmantation. ChangH mada to Improva coda quality, lueh ai improving indantation of 
coda, raicauaneing labali for raadability, adding or updating documaniailen or eorraeiing lltarary arrort In it, luppratilng radundint 
information or raplaclng multiplymceurring tactloni of coda with proeadura calli. Cwraotioni of violationi of programming itandardi, 
and datign Improvamanti that ihould hava bnn viiibla in tha functional tpaciflcatlons of eomponanti of tha lyitam ara to ba traatad 
M arror corrKtioni. Ooeumanution updatai mada concomitantly with a change ihould ba traatad m a part of that change and cluii. 
flad with tha primary cauia of tha change. 

Improvamant of Uiar iarvicai. During lyitam davalopmant, Individual programman may find that with vary littia extra work they can 
provida tha uiar with additional facilltiai on top of tha functional raqulramanti of tha lyitam. Such chingat are ciaiiad ai improve' 
menu to mar tarvicaa. 
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InwrtiM/OtMM at Oakuf (m ChtnfM mi4« w tN preartm M»t WMiftMlIy to provMi tnformMiOA during tMt runt lo 

tKii trroft am ba iwliitb. 

OaUmitt Tlmt/Miat/Aatuftav. An 091 tmtutim It a loeailfttf abiMtmam a( tba preram wbem main purpow it to radtiea iti aaaeu- 
lion lima or mamery >aquirmtann, or to attain raiulu of rtH** nuntarkal aocuracy ^ tunini tha alporlttimt um 4 to tha ipaeKIc 
roMam bainf lelvtd. 

Abapttoon M Inaironmmt Chanpa* TUt ‘'bewndary" of a wfMart tyita,'t it d»finad to Inatuda {uit ttwM prorami whoM dovaloe* 
mant and matniananca It bainf moniiorad at part of ttw loftiwara anfinaarinf laboratory ro|aet. A abanfo wfwM cauia Hat outiida 
tMi boundary la.f.. In ratoonM to an oparatinf lyitam, oempilar, or hardwtra abanfof it rtgardad at anvirenmemtlly eautad. 

Wh mora man ona eomponani afftctad by tha ehaneaf A componant It dafinad to ba diractly Involaad In a chanft if it eonuint 
Mbroutinat mat ira chanpad and it eomaint no lubeomponanti containinf thoia wbreutinat. Chack yat if tha ehanea dirtctly involvat 
mora than ona component of tha lyKam. no othanwiia. It may ba tha cam that a ohanft to ona lubroutina/eemponant Mill raouira 
Mina future tdiuttmani In othar eomponanu (thata aomponmtt may not aym hava bam aodad yat, or their adaptation may ba poit* 
ponad). In luch catai, tha af faett of tha ehaofa inaolvi more thm ona componant avm thoufh only one module wat noted ai ehtofad 
on thit form. 


•ICTION e-TYdl OF IRNOn 

Check tha one box that ban daicribat tha error. If none of tha error daMriptioni laam to fit, check othar r.'.dfiva a dattilad do 
Knpiion of ma error m Section C, 

flequiremanti Inaorrect ar Mhinterrated. Itedulramann may ba inoorrect (Inaomiitmi or ambifuouil, or thair maanini may ba mil- 
interpratad, In either caia, an error of mil type, if undatactad early, may propafata throufh deeifn and into code. Kern if undatectad 
until aecaotoroe tettinf (or malntananeal, arrurt raeultinf from ineorroct or mliintarpratad raouiremmli thould baolaulflad In the re- 
quiromma error catcfory. 

Funational IpoaHlaatione Inoorrect or MMntarpratad. Functional tpoelflaiitioni era taken to ba a ipaeiftcation of a eomponent at a lat 
of functiont dafininp the output for any input. Kmiltr to raquiramenti, ipaeifieaiione may ba either incorrect or mipntarpreted. Er- 
ror! In the ipac ficationt that occur m a raeult of mitunderita ndinfi of raquirementi era cloiilflad oi mliintarpratad raquiramenti erron 
and not Incorrect ipecificatiom. Specification erron that result from mliundentandinfi among thoia writing tha ipaeiflcatient are 
cleniflad ai incorrect ipecificitioni, Erron In code or deiign or documanti rewlting from Incorrect or mliinterprotad tpMificatloni 
mould be claulfled in tha ipecificatiom error category. 

•a 

Ooiign Error Inedelng Savarai Componanta. A deiign dKiiion li a ehoica of o'eaniution of a component into tubcomponenti, in- 
cluding tha ipocif ication of tha intaHaooi among tha lubcomponenta. A daiign error li a daiign dMliion that rawlti in ona of tha fol- 
lowing; 

o intorfooei that conuin inaufficlam, unnoeaMary, or rodundam information; 

• a Mf of lubeomponanti that do not Htiify tha leaeiftcationi of tha componant (l.a., ona or mora of tha Mbeomponami do 
not hava the oapabilitlai naadod to latiify tha uio intended for dw component). 

'I)er< tUk a daiign error may reiult from incorraet or mliintarpratad faquiremonti or ipecificat'ene. In tuch caiH, tha error 
mould not ba danifiad ai a daiign error, but aa a raquiramantt or ipacif ication mot. 

Error in the Daiign or Implainantatlon of a tingla Componant. Mott ilmpla, locolited programming miiukH fall into thli catagory. It 
coiC thaia caiei where tha organimion of tha lyitam Into componanti and their IntarfKai ii correct, but a particular componant 
dMS not behave according to its Intandad me (l.a., doat not corraioond to Iti ipaeifieation). Thii may owur baeauta tha algorithm 
mad In dailgning tha componant ii incorrMt, or bacauia tha implamamation of tha algorithm it Incorraet If tha algorithm hat a writ- 
ten ipaeifieation prior to coda generation, and tha ipMlfiatlon it incorrMt or miiintarprated, tha error it not elitiifiad at a dctlgn or 
Implamintaticn error, but an a ipaeifieation arror. If the erronoout algorithm hat no written ipaeifieation, or if tha implemantition of 
the algorithm hn errori not ittributabla to any other category, man tha error it claiiifiad aa an arror In the daiign or implementation 
of a lingla component. 

Mliundarttandingef External Envirenment, Exaapt Languaga. ChKk thli box if me error raiulted from miitakan aitumptioni about 
the hardwara or loftwara environment in which the program oparatn (i.a., that loftwara outiida tha “boundary” of me projact-iea 
"idapution to environment change" in Soction 8). Included here are miitakan iiaumptioni about how tha operating ivttem worki, 
about how tha hardwara it eontroilad, about mponia of paripharali to varieua eommandi, about tha operation of me library lyitem, 
about me intarfKa to ipMial t^iiplay hardwora or .jftwara, ate. 

Error in Uie of Programming la ng uag a /Compllar. Erron in tha uia of ma language/compilar ora thoia erron that rHult from loma 
miiundantanding of how the compiler worki, how the language provided run-time lupport lyitem operatai, or tome miiunderitanding 
of particular language featurai. Not included in thii category ara clerial erron (a.g„ typoil that lead to compilation erron. 
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ClMIMi IlnM WiOll 4 I« ItMl* tIK'lt Util iKXUI lit Uti tttKittItItil ItilttlillUit vt( lit > 111)1 llUttt ttltf flllittil l,> ilttiUtif II , vtl)« 

k'UUlitti iltMl Ut titulltci) tti ('(tm oiti )tiilitii)< M tititthM It 4 t'Oiliitt ihitll M t'Mtlil ^kt uiIttititltiiDn tu witiiiilit litoililidit i| iit 
tkllVtll 'It lut'lt • iMlHitt 

rCIN 01 SION OR IMRLSMENTAriON INNORI ONLY 

thii lit IMD tliituiil (It I'lIttI iHil itDiy 'i Utt iiiyti tvii i U«ii«n tiioi >iivul«iiig littrii > i<iii|viititu iv if i| tvii tit iiiar iit Uti itt 
■i^t ot iittiiiimntiiiitMt of t iiit^lt cttiiiiijitttti liioii ilttt oetui iit lit# tttiiii<t of t iviuitt lutnviititt. tti of ounipoittitii or illicit 
lOltl|K«*ltltt III lit lit* lltlltlWIXNtUllltlt of t IlltOl* I OlttllOltWtl ItttV N ktlttfltllftO III oil* of IMrO WItVI lllhtf llt*l* tVtl tit tOlM III |h* 

It* of ilil* or iftii* MM ill tmt) lit lit* fiiitciioit of * contiMittiti IiikIi m tii tltouittmiu or coitioultiioittl trior iMuliiitii irt pro«ititt 
lolitvioi itol lonttitoittliiiti to III* ■iti«itO*il III* of III* iHOortitil Oitt iiM ttioil I'tit lit t'hatti-lM'tttl ti •ilhtr nicoiitcl vtlott foi 
iliti Kiiii 01 ><'i<ioi)*i iiiiiiiiii't 0 '<t ilViil (It* tl'iMiu* ol ilili iltiin I* I) , iitiv til (4 oi Oiiii*iii 10)11 or oiOt'nid Oi >l*itti "t t iilO 
t iioit 'iitt<itiii|| III* ftiiH'i on of • «tMti|Hiii*ii| iiiUinl* iviiiioi iiul I'omimiitioiitl mioil. luih ai in'oiiaci i»i|u*iirnio ot iltl*iit*iili. 
oinill*tl Mal*iii*ii|| iMliait luilt an not I'ltiiial *110111 itti|tio|!i*rly tomoolttl taprcuHtiti. oiniuttl i:tti*ttillii*i of III* komooittitlli). *U' 

SICT> 'IN O-VALtOATION ANU RIPAIN 

Aftai omr* ih* ai'iitiliM iiiatl lo laliiiti* Ilia irro*r*m. In dal*«t III* tiro*, aoil flitif III mui*? 

fit* |nit|)>vi« ol Util ttil'Oit 10 tl.ti'ovtr liotv >1 Iwv'tiit* fntowit Util tit airot *1111111* aiitl ftott tit* tain* of ill* «mtr tvai vltltr 
oiiit*il A t litt-K tliniilO I* out 'll III* iiitl ivliiittii lot **t li 'ii*tliotl 111*0 ft') vaiiOaiut* III* I’oiniHtittnllil t\lt»r* lit* tiior tvai fouiiO A 
tlii>«.lk ilioiml l<» out It III* itioiiil lOitiiiiii on III* tain* nt* ai 111 * >ti»UioO li> ttliiiii III* t> inoloim Ol lint oaiticulai viior wit fiiit 
' 101*0 Th* iliiiO anO loinUi lOlumiit r»l*i lo at livili*i iir *0 lo fmO III* lain* ol Oi* ttiol vine* if tvat liliotvil Ihai ru* tnoi *vll *0 
III III* iliirO lOii'iiiit iiitvii all l(t'lmiiiii*i nitO m Uyiiti It) fiitO fit* t'atii* ol ill* *ritv In lit* foiirift iStliinm cittcK m o* i*i:ii'tit|ii*i 
llial vitltltO tit* 'itloiitialioit it**tl *0 10 *inO m* i ttit* In tom* omh nrcfi at loiti* airoii louitO liy root laaOm*. tit* tr;ltitii|u*iil uiau 
to *MtO lit* amir tiiO Oiii:oti*i ill coin' twill li* ih* itni* Not* titti trior ni*ita**a Itaii* lt**tt OiviOaO into lt«o c*l**ori«i titoi* itio 
inicaif Ity lit* iiipiMi I lyiltitt I* * . ooittinlar .<)t*rttiit* ivilantl, ami Ifiot* tl«ii||it*if ntlo lit* t'liO* f>tr t*t* ipaciflc iHiriMiMt of tfi* piO| 
wt Tttitit* hai alto l>**it OivtiftO info Ittro i,'ait*)tii*t tail rtiiti niaO* prior to *i'C*|!t*m!« 1*11111* i|ti* tt'ccottiH'* 1*11 ruitil. aitO ar 
i'*iti*iH'* taut If tPiiviiiM oift*i than iliiw* litiaO iit lit* util* ttm* ui *0 iit fiitOm* iR* *rit>r 01 Oitctiytriii* ill cauu, (Rack oiNi in tit* 
MH)<0|Mi*t* coltiniit, anO OMcnb* lit* asiivitiat in*tl in Saciion 6 Ttiii lalrl* nuviiattlv ft*t font* nOtmOtney a eltai'k in column } 
molt aitwavt itav* a rorraiuttiHlniii chacli in loiunin I, iimilarly twiilt coiuitini 4 aitO 3 

Wful tmii llM lint* utaO to uotai* tit* oauiaf 

I'lim'k III* iivit* iliai moil I'lotaiv 4 |t)tioyiniai*i lit* tint* i*t|uiitKl 10 nolai* lit* cauu of tii* «noi Tim ihitiilO tt* tit* total of 
III* um* ihal tvwi iiiaiti in tit* acilviliai lti»il 10 fino ilia cant* If tit* caui* of ih* amir tvai n*y*r t'tinO. anO a itnnktiouitO tv«i uitil 
citack Ih* ai>itiii|<Mtl* twn If tft* cant* twM n*«*r foiiitO anO a tDorkattttinO urM noi iiiaO, aaolaiit tit* citviiniiltneat in Saoiioit G. 

Wm IM* trrtw laltIMl to a laavloui *lian**f 

Cfta<t**t 10 loftvMr* ntav niult m trioii liactiii* of on* or ntoi* of Mvaial laaioni 

• tft* ditn** t«*t inctMtacily mt|tl*itt*ni* 0 . 1 * . OiO not conforitt 10 ift tpaciflcalion, 

• Ift* cfiaiiii* inv*iulai *0 an Mtumpiion miO* aliawfui* in lit* titfttMi* 

• an autintiiiuMt mail* atMiil ih* 1*11 of m* iutitw*i* in lit* 0 *ii*n of ih* efttn** w*i iiK't.wr*c< 

Alt arior 11 i*l*i *0 lo a praviout cftan** if if rMtiiit ffiom on* of ifw atov* iftra* conOiiUMtt Irrort ifiai an uitcomaO tiy clt*nii*i, 

I *. an arror mMkaO tty anoift*r iftai 11 r*y**l*<l twh*n tfu latlar it uorracinl. do not tolon* In iftit caiayory If tfi* arror it raitttd 10 a 
|H*«iout ttftait**. *)«* Ift* nuntMr and dau of Ih* chait** i*|iori fomt of lit* l•l*l*d chan** Wh*n did lha amir «iii*r ih* tyttamf 

Clttck III* iMVi Ihal ntoit clotalv nimianit tft* phtM in ih* tmtntoui componomi datuloiinuni In tvhieh ih* arror tvai imroduc*d 

SICT10N l-ADOirtONAt. INPONMATION 

Thu taction it mtandad to oarntii fuitftar aaoltnailon of any itami you fml may b* iisnillcaitt lit cataforitin* th* chan** (111- 
citidm* arror corrtctioml If IN •\tth»r'* cai«*orv w*t ch*ck*d in any of th* pr«yioui lactioitt of th* form, a foliar «aiM*itation ihouM 
It* fiiion h«r*. t)o itot h«aiiai* to i|i«* a full datcnpiion of IN arror or chart** or any doubii you nuy hay* in clatiifyin* 11 Th* *c 
ctiracy of our tiulvtit it d*|t*tHl*ni oit th* tntouiti and accuracy of IN data you proyid* for ut Tti* ttudy tv* tr* itarfoimin* n an *1 
lantitt to tfo a cartful, datailatf inii*tli*liion of Ih* itrocatMt that «o on duu>i>,t lOfftvar* ifavaloomartt, th* kindt of chartoat and arrvitt 
INI occur khinn* tf*«*U)ont*nt, and th* r«Moni foi iNir iKCtirrtnc*. With yyiur Nip, tt* Itop* to **in aitoiaih iniighi into th* tfaiidn 
mdiitti, and utiin* of itroyrtint to that ivopoud itchniquai for copln* vviih lofiyytr* chttt**i and raduent* IN nuntltar of anon can b* 
tytluatad Your cottptrttion and patianc* in eontiilatrtt* th* chart** upon form trach tittt* you nitkt a chan** to • documani ot pro- 
gram *r* n**d*d artd apt<r*Ci*t«>t 


» 
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CNANUI NKIKJMT FORM 


NiHMilN 


MU'JdOr NA\<|! 


CUNNINr CIAU 




.sa>'. a : tHmtss.vmK.- 


»Ii:tiO,N a U^INfiriCAtlON 

MKAitlN V%hv Ww t'NiMi* **»k(».* . : a... 

Ulti'NirrtON «»«»>«» 


CFflCr \VK«« «• lAtitvM? ilnHtttM MnMnt. 


:.:ne. Tr ’. •. as j. 


■'.'•3 yur . 

■srrx 35 sr-r :3 ..** ~x.z 


. «. r »:=:«-* ,Ta:=: 2 -. v'r:.sr- 
■c-rv ...■:; .tsK-. g »T-~a»r;to» - uim.mn- 


• 3 SSS -r '30ST 




V»h«( liU tn whit «hi«# WM 


tMkinth Div N»«t) 


r E tt;;- 


NmA Kh kNHtWHWkI wi 

Chiton* 


I L_l 

i. ... L 

Ahil w«i ihi itVM Ml (ti««i liiKihiM mh* imtM<wi«H thi «h«M|*f 


.ad 


. t hmif w ti*»- 


I tMur M I Mty 

r. : 3 « .• ** stmT. .ws^KHcca* 


I «t<y H! } liin, 


.tWH« than ) «(«y* 


Stv'TKV< I vtF CMANill >H«« *% ihM ihihtii hHI thi m ewHigi*?) 

. ' Cmtr 0 lnwrthh> ilvtitiM «tf «Mhu« kVt» 

l1 («( >i«nifr«m««u «!h*«i«t U AitatHaihin M «th«n|* 

O i«« Withy nwHttiHtihiKtv m thNvHtwttWMM □ Othit (latMMt in I) 


Ij ImtMhVttttittl tsf tl«M IWViM* 

Wii hMii thin itni (MnttMntnt irfMWiI hy ih* nhtniiir Vw 


,Na, 


FOR IRROR OORNiCttONi ONkV 
MOTION C - TVft OP IRROR |N«w ti thM *H«r hM yhWMWtMtHh 


y RMviyyniittti iitmt«i«t w ntWintittit«tt<l 
y PutWtMnit WIMlhyMMrtl tn<wti«<M At nthinwttMitM 
y OHiiti4 tmtt MMMhHyi MMiit tMtniNMtimt 


y MiwH«*«it«n<ltn4 •! Mtwhit ttwiminihStR, mm«N litmuiP 
O Iffni yii nl pnii|ta9tiintni| lantiuiaaiaatniMtif 
y CtMi«ali«m 


a 1 (tn»< m thi ntUfi nt tmnhNnintitHMt nt i iwdli iwnwwth □ Othw (Ikntttn <n It 

POR DHION OR IMPUMINTATtON IRROR! ONLY 

^ <1 it thi wttM wM m »tM«(in w i w tttintinwthin 

Ihi itfni MM i intitMitt Miunt|HMn MMMrt thi «itui m imwnHi of I«m 


Thi i«4«t WM I mtMiki M Mtttrat la|i« at MitHtutitthn «it tn MiMMiMn a 
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original page is 

OF POOR QUALITY 



ran IRflOR CORRICTIONS ONLY 
SICTION 0 - VALIDATION AND RSRAIR 
Wnit Ktivitin «Mt« uMd 10 viiion tfw prortm, OtiKt Ow «rrof, mO finO la etua? 


Pmceipttnc* mt mm 


Accopiann ttttinp 


AeOvitlM 

JHOfer 


VNMotien 


Aeti¥lllM 
luaeHiAil 
In OtMtinf 
Irrer lymptomi 


ActivIMi 
TrlfO to 
PinO 

Caua 


Actiyllin 
Sueotaful 
In FinOint 
CWH 


Inir <0000 of output 


CoO* nidino by proorimtmr 


Cod* ntdinq by otfiir porion 


Tilki with othtr pro«rimm«rt 


SpMitl dtbug eodt 


SviMm trror mttiiqti 


roltfft lotcifie trror mtaaOH 


Rtiding documtntition 



Dump 


CroM'rtftttnet/tivibuu lift 


Proof Mdiniqut 


Othtr (Explain In E| 



What wti tha tima uitd to iiolata dw cauw? 

— _ont hour or laut — .ont hour to ona day, _ 
If navar found, waa a workaround uMd?__^Yai. 

Waa thia trror tolaitd to a pratioi'a cbangtf 

___Yti (Chang# Rtport i _ 


Whan did tht trror tnnr tha ayttamf 
rtquirtmtntt __l 


.funetlonti ipaia 


.mora than ona day, _ 
No (Explain in El 


.Can't tall 


.adding and taat 


.navar found 


.can't tall 


SECTION E • ADDITIONAL INPORMATION 


Plaaaa giva any information that may ba halpful In eatagoriaittgtha arror or ehanga, and undamanding la eauta and in 
ramificatior)!. 


.Authorizad:. 

























ORfGINAL PAGE fS 
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Currtnt Date 


Attituda Syittffl Haintananca Rapsrt 


Projact ‘lama W aad for Changa dacarmlnad on (Mo., Day, Yr.) 

Oaacrlba Changa 


What componanti/subroutinas/modulas ara ehan«)ad 


tilAliflg (H1l out this aaction i( changa (s 'idir an arror corraction) 

This changa <s baing mada baeausa of a changv«t in: (Chock all that apply) 

raoulramants h ardware anvironmant 

now information/data l oftwara anvironmant 

soacifi cation o otlmlaatlon 

____ dasign 

other (specify): 


ERftOii ONLV (fill out this section if cKanga an error correction) ‘ 

The following activities ware used In error detection or Isolation: (Check all that 
iPpTy) (Put 0 for detection, I for isolation) 

_____ normal use t race /dump 

test runs c ross rafaranca/attituda list 

___ coda reading s ystem arror messages 

_____ raadinn documentation p roject specific arror massages 

other (Specify): 

Which of the following bast describes the arror: 

____ raqulrrmants arror s oacifi cation arror 

___ dasign error c lerical arror 

_____ error In translating dasign or specification to code 
other; Daserlba 

Was this arror related to a previous maintenance changa v as n o ■ can’t tall 

Please gLve any Information that may be lelp^ul in categorizing and understanding the 
changa on the revarta side of this form. 

Parson filling out this form 

Approved D ata 

Changa started on date (month, day, year) . . ■ — 

Tima spent on this changa: 

Itss than 1 day 1 day to a weak m ore than a weak 
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F.2 SEL GLOSSARY OF TERMS USED WITH DATA COLLECTION FORMS 


This section defines the terms used in the software engi- 
neering data collection forms reproduced in Section F.I. A 
more extensive glossary (based substantially on this one) is 
found in Reference 6. 


assignment 

statements 


attitude/orbit 


attribute list 


All statements that change the value pf a 
variable as their main purpose (e.g., as- 
signment or READ statements, but the as- 
signment of the DO loop variable in a DO 
statement should not be included) , 

Any component that is directly related to 
either the attitude determination (or con- 
trol) task or to the orbit determination 
(or control) task falls into this cate- 
gory. This should include full systems in 
general (such as GTDS or ISEE-B Attitude) 
as well as specific modules such as Deter- 
ministic Attitude or DCCONES. 

A compiler-generated list of the identi- 
fiers used by a program that describes the 
characteristics of those identifiers and 
shows che source statements where they are 
first defined (or first used) and, for 
variables, their (relative) storage loca- 
tions. 


automated 

tools 


baseline 

diagram 


Any programs whose purpose is to aid in 
software development (e.g., compiler, text 
editor, or dump or trace facility) . This 
includes compilers but not standard opera- 
ting system software (e.g., linkage edi- 
tor) . 

A structured chart listing all components 
in a system in which a connection from a 
higher component to a lower one indicates 
that the higher component calls the lower 
one. 


batch Use of a computer in which the entire job 

is read into the machine before the proc- 
essing begins and in which there is no 
provision for interaction with the sub- 
mitter during execution of the job. (In- 
teractive usage is always via a terminal; 
batch usage may be via a terminal or a 
card deck.) 
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bottom-up 


business/ 

financial 


change 


clerical 

code reading 

command/ 

control 

complexity 


component 


The design (or implementation) of the sys- 
tem starting with the lowest level rou- 
tines and proceeding to the higher level 
routines that use the lower levels. 

The second of the four major categories ap- 
plies to components related to some ac- 
counting task, financial data formatting, 
business data retrieval or reporting, or 
possibly personnel data management. Very 
few of the components being studied will 
fall into this class. 

A modification to design, code, or docu- 
mentation. A change might be made to 
co’*rect an error, to improve system per- 
formance, to add capability, to improve 
appearance, or to implement a requirements 
change, for example. 

The process of copying an item from one 
format to another or from one medium to 
another, which involves no interpretation 
or semantic translation. 

Visual inspection of the source code by 
persons other than the creator of the code. 

This class of components includes those 
used either to generate vehicle commands 
or to transmit these commands from the 
control center. 

Measures the difficulty of implementing a 
component, independent of the imple- 
mentor's experience. Easy (or simple) 
means that any good programmer can write 
down the correct code with little thought. 
Hard (or complex) means that much thought 
is involved in the design. (Compare this 
with "precise”; e.g., easy and imprecise 
may mean a vague specification, but once 
the approach is decided upon, the code is 
easy to write. ) 

A piece of the system identified by name 
or common function (e.g., separately com- 
pilable function, an entry in a tree chart 
or baseline diagram for the system at any 
point in time, or a shared section of data 
such as a COMMON block) . 
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computer time 


confidence 

level 


constraints 


constraints, 

space 


constraints, 

time 


control 

statements 


correction 

cosmetic 


create 

creation date 


cross- 

reference 


For batch usage, this is the billable time 
for all runs. For interactive usage, it 
is the number of hours spent at a terminal 

Percentage probability that a given number 
is correct: 100 percent means that the 

number is absolute certainty; 0 percent 
means that the number must be incorrect. 

Restrictions on resource availability (ex- 
ecution time, memory allocation) imposed 
by specifications. 

All restrictions caused by space problems. 
On the Component Summary Report form, list 
each restriction separately (e.g., maximum 
number of words that component may occupy 
at cne time or maximum disk space avail- 
able during execution time or for program 
storage) . 

All restrictions caused by various machine 
and calendar time problems. On the Compo- 
nent Summary Report form, list each re- 
striction separately (e.g., maximum 
execution time for component to process 
and respond to some input condition or 
time to complete a component or milestone) 

All statements that potentially alter the 
sequence of executed instructions (e.g., 
GOTO, IP, RETURN, or DO). 

A change made to correct an error. 

Changes in the source program that have 
little effect on the performance of pro- 
gram (e.g., correct comments, move code 
around as long as it does not alter the 
algorithm implemented, or change the name 
of a local variable) . 

The creation and recording of the idea. 

Date that the component was first named 
(e.g., date it first appeared on a tree 
chart) . 

List of the Identifiers used by a program 
showing (by means of indices or statement 
numbers) which statements of the program 
define and reference those identifiers. 
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data base 
applications 


design 


design phase 


design reading 


development 

phase 


documentation 


dump 


end date 


English (or 

informal) 

specifications 


This category is to include components that 
retrieve, write to, or format information 
for a well-defined formatted bank of in- 
formation available to the system. The 
user must decide whether or not the data 
set is to be considered a data base. An 
example of an acceptable data base would 
be the ADL file, SLP file, or Geodetics 
file, whereas a sequential telemetry file 
or tape would not be. 

A description of what the system must do, 
its components, the interfaces among those 
components, and the system's interface (s) 
to the external environment. 

The creation and recording of the design, 
including discussion about strategy with 
peers. This phase does not include the 
development of any code at the programming 
language level. It does include the crea- 
tion of specifications for subcomponents 
of the current component. 

Visual Inspection of the design by persons 
other than the creator of the design. 

The development and recording of code and 
inline comments based on the design. This 
phase includes the modification of code 
caused by design changes or errors found 
in testing. It does not include any time 
spent in entering the code into the com- 
puter. 

Written material, other than source code 
statements, that describes a system or any 
of its components. 

Record of the state of the memory space 
used by a program at some point in its 
execution. A dump may include all or part 
of the program's memory space (including 
registers) . 

Date that a project is scheduled to be 
completed. 

Specifications given as readable English 
text, as opposed to some formal notation. 
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error 


external 

environment 


formal spec- 
ifications 


function 


functional 

specifications 


hardest first 


HIPO (Hier- 
archical Input 
Process Output) 

implementation 


integration 

test 

integration 
test, full 


Discrepancy between a specification anf't. 
its implementation. The specification 
might be requirements, design specifica- 
tions, or coding specifications. 

Combination of hardware and software used 
to maintain and execute the software, in- 
cluding the computer on which the soft- 
ware executes, the operating system for 
that computer, support libraries, text 
editors, and compilers. 

Some specification technique baaed upon a 
strict set of rules for describing the 
^ specification and usually involving the 
* use of an unambiguously defined notation 
(e.g., mathematical functions or formal 
PDL) . 

Mathematical notation used to specify the 
set of input, the set of output, and the 
relationship between input and output. 

Specification of a component as a set of 
functions defining the output for any in- 
put. The specification emphasizes what 
the program is to do rather than how to do. 
it. However, an algorithmic specification 
can be considered functional if it is not 
used to dictate the actual algorithm to be 
used. (See procedural specifications.) 

Design (or Implementation) of the most 
difficult aspects of the system first. 

Graphical technique that defines each 
component by its transformation on its 
input data sets to its output data sets. 

Implementation of a program is either a 
machine-executable form of the program or 
a form of the program that can be auto- 
matically translated (e.g., by compiler or 
assembler) into machine-executable form. 

Test of several modules to check that 
the interfaces are defined correctly. 

Test of the entire system (i.e., top- 
level component) . 
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integration 
teet( partial 

intended 
use of 


interface 


interactive 


iterative 

enhancement 


level 


level, lowest 


librarian 


machine words 


manpower 


Test of any set of modules but not the 
entire system. 

Result of invoking a progra.n or segment 
of a program, including the actions per- 
formed by that program when invoked. In- 
vocation may be by subroutine or function 
call or by a branch to a segment of code. 

Set of data passed between two or more 
programs or segments of programs and the 
assumptions made by each program about how 
the others operate. 

Use of a computer via a terminal in which 
each line of input is immediately proc- 
essed by the computer. 

Design (or implementation) of successive 
versions, each producing a usable subset 
of the final product until the entir*^ 
system is fully developed. 

Unit corresponding to some partitioning of 
the final product (e.g., a single line of 
code, 10 lines of code, 2S lines of code, 
subroutine, or module) . If the system is 
hierarchically structured, each component 
is at a higher level than its .subcompo- 
nents, and the system may be described as 
the highest level component (the component 
at level 1) , the component at level 2, or 
the lowest level component. 

Smallest unit identified by the activity 
(e.g., code reading to the single state- 
ment, top-down design to the module level, 
or top-down design to level 3) . 

A clerk whose responsibilities Include 
processing source statements but not writ- 
ing them, (e.g., maintaining libraries, 
updating code, or producing tape backups) . 

Number of words in a main memory that a 
component occupies at one time. 

Sum, over the number of people, of the 
number of hours per person charged to the 
contract. 
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mathematical/ 

numerical 


maximum space 

mission date 
module test 
none used 

onboard 

processing 


optimization 


PDL 


This category is meant to be a more speci- 
fic category than the scientific class. 

It contains those components that reflect 
a specific algebraic expression or mathe- 
matical algorithm. Such components as a 
dot product routine or a numerical inte- 
grator are in this category. 

Total number of machine words that the 
system may occupy at one time. 

Date that system must be operational. 

Test of a single module. 

No explicit 'technique was specified to be 
used. 

All components that are built for the 
purpose of satisfying some onboard proc- 
essing need belong to this class. Al- 
though the component may be built and 
tested on a computer that is not the real 
flight computer, it nhould be classified 
as onboard if the final destination is the 
OBC (onboard computer). 

Changes in the source code to improve pro- 
gram performance (e.g., run faster or use 
less space) . Optimization changes are not 
error corrections; however, if a change is 
made to use less space to conform to the 
specified space constraint, then the term 
"error" applies. 

Program design language (often called 
pseudocode) . Used in the design and cod- 
ing phases of a project, PDL is a language 
that contains a fixed set of control state- 
ments and a formal or informal way of de- 
fining and operating on data structures. 

PDL code may or may not be machine- 
readable, and for this study it is not con- 
sidered as documentation, but as an 
integral part of the finished source pro- 
gram. 
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procedural 
specif ications 


proof 

technique 


range in mod- 
ule size 

read 


real-time 


requirements 


review 


scientific 


Specification of a component in some al- 
gorithmic manner (e.g.» using PDL or a 
flowchart) . The specification says how 
the program is to work. (See functional 
specifications. ) 

Method for formally demonstrating that a 

f iece of software performs according to 
ts specifications. Proof techniques usu- 
ally use some form of mathematical nota- 
tion to describe the result of executing a 
program. 

Number of source statements in i. module, 
including comments. 

The reading by peers of the recordings of 
the current phase to look for errors, in- 
vent tests, and so on. 

This class includes components that are a 
direct function of events occurrinc <it, or 
near, the current time. Typical compo- 
nents would be the Attitude Control 
Monitors. Since parts of most of the te- 
lemetry processors are required to process 
data as it is received, they too may be 
considered real-time components. 

System specification written by the user 
to define a system to a developer. The 
developer uses these specifications in 
designing, implementing, and testing the 

system. 

Formal meeting of several individuals for 
the purpose of explaining design (man- 
agement review) . Also includes the time 
spent in preparing for the review. All 
those attending a review should list the 
components discussed in their own Compo- 
nent Summary Report for that week. 

A component may be in this category if it 
is related to some mathematical algorithm, 
engineering problem, law of physics, or 
celestial mechanics problem. Most of the 
full systems developed will fall into this 
category, whereas the various pieces of 
modules may fall into some of the qther 
classes. 
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shared items 


simulating 

constructs 


source 

instructions 

source 

statements 


specification 


specification, 

imprecise 


specification, 

precise 


Contiguous piece of code that is unnamed 
and, hence, cannot be referred to as a 
single entity in a program statement. A 
segment could be one or several lines of a 
subroutine, part of a data area, or an 
arbitrary contiguous section of memory. 

Data and programs, accessible by several 
components, such as COMMON blocks, ex> 
ternal files, and library subroutines. 

Statements that are used to simulate struc- 
tured control structures when the language 
to be used does not contain structured 
control structures. 

See source statements. 


All statements readable by and read by the 
compiler. This includes executable state- 
ments (e.g., assignment, IF, and GO TO); 
nonexecutable statements (e.g., DIMENSION, 
REAL, and END); and comments. 

Description of the input, output, and es- 
sential function(s) to be performed by a 
component of the system. The specifica- 
tion is produced by the organization that 
is to develop the system; that is, at the 
top level, it can be thought of as the 
contractor's interpretation of the re- 
quirements. 

The inp't, output, and function of the com- 
ponent are loosely defined. Much of what 
is required is assumed rather than speci- 
fied. The specification relies heavily on 
programmer experience and verbal communi- 
cation to get an unambiguous interpreta- 
tion and a full understanding of what i^ 
needed. 

The input, output, and function of the com- 
ponent are well defined. There are under- 
lying assumptions not specified, but it is 
assumed that any programmer working on the 
project, with experience on a similar 
project, will understand these assump- 
tions. It is possible to arrive at an am- 
biguous interpretation or misunderstanding 
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specification, 
precise 
(Cont 'd) 


specification, 
very precise 


specification- 
dr iven 


standards 


start date 


string process- 
ing 


structure- 

driven 


struccure 
of data 


structured 

code 


of the specifications if the reader does 
not have enough experience with the prob- 
lem or does not obtain further verbal com- 
munication. 

Completely defined description of the 
input, output, and function of a compo- 
nent. The implementer of a very precise 
specification need make few, if any, as- 
sumptions. It is almost impossible to 
arrive at an ambiguous interpretation or 
misunderstanding of the specifications. 

Using the specifications of the program to 
determine test data (e.g., test data is 
generated by examining the input/output 
requirements and specifications) . 

Any specifications that refer to the 
method of development of the source pro- 
gram itself, and not to the problem to be 
Implemented (e.g., using structured code, 
at most 100-line subroutines, or all names 
prefixed with subsystem name). 

Date on which initial work on a project 
began. 

This includes components that perform op- 
erations on lists of characters. Norm- 
ally, this class is assumed to include 
functions of compilers, hash code string 
hook-up, and array comparisons. 

Using the structure of the program to de- 
termine test data (e.g., generating data 
to ensure that each branch of a program is 
executed at least once) . 

Organization of a composite data item con- 
sisting of several variables or other 
array Items. Examples of such composite 
data items are arrays (both singly- and 
multiply-dimensioned), strings, complex 
variables and constants, records on a disk 
file (each record containing several 
words) , and multiple-word entries in a 
table. 

The language supports structured control 
structures (e.g., a FORTRAN preprocessor). 
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systems 


system si?.^ 


table handler 


telemetry/ 

tracking 


testing phase 


top-down 


trace 


type of soft 
ware 


By system-related software# one includes 
any package designed to affect# modify# 
extend# or change the normal available 
processing procedure of the operating sys- 
tem. This could include such components 
as error tracing or extended I/O such as 
-^MO. 


Total number of machine words needed for 
all instructions generated on the project 
plus spruce for data# library routines# and 
other code. This is tho total size of the 
system without using any overlay structure. 

Includes components that are specifically 
designed to generate or interpret informa- 
tion in a table format such as the Gener- 
alized Telemetry Processor. 

Includes all components that are spec- 
ifically required to interface (either 
read# write# or format) with telemetry or 
tracking data. 

Design of tests# testing strategies# and 
the running of such tests. This phase 
does not include the writing of any code 
(even for debugging purposes) # which 
should be recorded under coding. 

Design (or implementation) of the system# 
starting with a single component# one 
level at a time# by expanding each compo- 
nent reference as an algorithm possibly 
calling other new components. 

Record of program execution showing the 
sequence of subroutine and function calls 
and# sometimes# the value of selected var- 
iables. Code used in producing a trace is 
automatically inserted into a program# 
usually by the compiler# sometimes by 
other support software. 

The four major classifications of most of 
the applicable software being developed 
are: scientific# business/financial# 

systems# and utility. These classifica- 
tions may be refined into the categories 
of: string processing# data base 

applications# real-time# and table 
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type of soft- 
ware 
(Cont'd) 


utility 


value of data 


walkthrough 


workaround 


handler. A further refinement includes 
the categories of: attitude/orbit, 

telemetry/tracking, command/control, math- 
ematical, and numerical onboard. 

Any component that is generated to satisfy 
some general support function required by 
other applications software may be con- 
sidered a utility. This class of compo- 
nents usually contains software that does 
not fit into any of the other three cate- 
gories. Although components can fall into 
two of the primary categories (e.g., 
scientific and utility) , it will be easier 
to use only the more descriptive of the 
categories (e.g., vector cross-product-- 
scientific; data unpacking--utili ty) . 

The number and kind of number {e.g., in- 
teger, floating-point, or ASCII-encoded 
character) stored in a local variable o.. 
data area, parameter, common variable, or 
system-wide data item. 

Formal meeting sessions for the review of 
source code and design by the various mem- 
bers of the project for technical rather 
than management purposes. The purpose is 
for error detection and not correction. 

The method used to counteract the effects 
of an error in a program when the cause of 
the error and, consequently, the location 
of the statements containing the error is 
not known or is inaccessible (e.g., a com- 
piler error) . 
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